home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / bbs / tbbs110.zip / TRIBBS.DOC < prev    next >
Text File  |  1997-03-10  |  202KB  |  4,062 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.                       The TriBBS (R) Bulletin Board System
  33.                                   Version 11.0
  34.                     Copyright (c) 1997 By Freejack's Software
  35.                         Copyright (c) 1991-96 By TriSoft
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                 COPYRIGHT NOTICE
  43.                                 ----------------
  44.  
  45.      TriBBS is a copyrighted program being distributed under the  shareware
  46.      concept.  As such, you may operate a TriBBS Bulletin Board System  for
  47.      a period of 30  days without registering the  software.  After the  30
  48.      day evaluation period, you  must register your copy  of TriBBS or  you
  49.      will be  in violation  of United  States and  International  copyright
  50.      laws.
  51.  
  52.      As a shareware  program, TriBBS may  be freely  distributed through  a
  53.      BBS, through a computer network like  Internet and FidoNet, on  floppy
  54.      disks, and on CDs or other optical media.
  55.  
  56.      It is a violation  of the TriBBS license  agreement to modify the  EXE
  57.      files in anyway.
  58.  
  59.      TRIBBS KEY  FILES AND/OR  REGISTRATION CODES  MAY NOT  BE  TRANSFERRED
  60.      WITHOUT THE EXPRESS WRITTEN PERMISSION OF FREEJACK'S SOFTWARE.
  61.  
  62.                              SHAREWARE LIMITATIONS
  63.                              ---------------------
  64.  
  65.      Until TriBBS  is  registered, it  is  limited to  using  five  message
  66.      conferences, five file areas,  and five doors.   These limitations  do
  67.      not hamper the would-be TriBBS sysop's  ability to fully evaluate  the
  68.      software; yet, it does encourage registration by sysops who are  truly
  69.      interested in running TriBBS.
  70.  
  71.                                     WARRANTY
  72.                                     --------
  73.  
  74.      TriBBS is distributed without warranty.   In no event will  Freejack's
  75.      Software be liable to you for damages, including any loss of  profits,
  76.      lost savings, or other incidental or consequential damages arising out
  77.      of your use of or inability to use the  program,  even  if  Freejack's
  78.      Software or  an  authorized  representative  has  been  advised of the
  79.      possibility of such damages.  Freejack's  Software  will not be liable
  80.      for any such claim by any other party.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.                                    TRADEMARKS
  89.                                    ----------
  90.  
  91.      TriBBS is a registered trademark of Freejack's Software.
  92.  
  93.      RIPscrip is a trademark of TeleGrafix Communications, Inc.
  94.  
  95.      All other trademarks are the property of their respective owners.
  96.  
  97.                                 ACKNOWLEDGEMENTS
  98.                                 ----------------
  99.  
  100.      TriBBS uses the excellent  SPAWNO routines by  Ralf Brown to  minimize
  101.      memory use while shelling to DOS and running other programs.
  102.  
  103.      TriBBS supports the RIPscrip graphics protocol, which is a creation of
  104.      TeleGrafix Communications,  Inc.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.      TriBBS Bulletin Board System                                         i
  111.  
  112.                                TABLE OF CONTENTS
  113.                                -----------------
  114.  
  115.      INTRODUCTION.........................................................1
  116.  
  117.      REQUIREMENTS.........................................................3
  118.  
  119.      INSTALLATION.........................................................4
  120.       Automatic Installation .............................................4
  121.       Manual Installation ................................................7
  122.       The Menu Configuration Files .......................................9
  123.       The Help Display Screens ..........................................10
  124.       The Default Language File .........................................10
  125.       Modifying BOARD.BAT ...............................................10
  126.       Getting TriBBS to Run on Boot Up ..................................11
  127.       Your First Log On .................................................12
  128.  
  129.      THE TRIBBS MANAGER..................................................19
  130.       TriMan Odds and Ends ..............................................19
  131.  
  132.      THE WAITING FOR CALLER SCREEN.......................................20
  133.       The Waiting for Caller Screen Menu ................................20
  134.       Drop to DOS .......................................................20
  135.       Configure Node ....................................................20
  136.       Edit Conferences ..................................................21
  137.       Edit Users ........................................................21
  138.       Edit Events .......................................................21
  139.       Configure System ..................................................21
  140.       Edit File Areas ...................................................21
  141.       View Callers Log ..................................................21
  142.       Pack User File ....................................................21
  143.       Exit TriBBS .......................................................21
  144.       Pack Message Base .................................................22
  145.       The Modem Status Window ...........................................22
  146.       The Statistics Display ............................................22
  147.       Screen Blanking ...................................................22
  148.       Status Line .......................................................22
  149.  
  150.      DISPLAY SCREENS.....................................................24
  151.       @-Variables .......................................................24
  152.       Log On and Goodbye Screens ........................................27
  153.       Security Specific Log On Screens ..................................28
  154.       User Specific Log On Screens ......................................28
  155.       New User Screen ...................................................28
  156.       Bulletin Menu and Bulletins .......................................28
  157.       Main Menu .........................................................28
  158.       Message Menu ......................................................29
  159.       File Menu .........................................................29
  160.       Upload Screens ....................................................29
  161.       Download Screens ..................................................29
  162.       Door Menu .........................................................30
  163.       Door Bulletin Menu and Door Bulletins .............................30
  164.  
  165.  
  166.  
  167.  
  168.  
  169.      TriBBS Bulletin Board System                                        ii
  170.  
  171.       Questionnaire Menu ................................................30
  172.       Sysop Menu ........................................................30
  173.       List of Conferences ...............................................31
  174.       List of File Areas ................................................31
  175.       Chat Screens ......................................................31
  176.       Log On Related Screens ............................................31
  177.       Comment Screen ....................................................32
  178.       <F8> Logoff Screen ................................................32
  179.       Full-Screen Editor Help Screen ....................................32
  180.       TeleChat Help Screen ..............................................32
  181.       File/Byte Ratio Screens ...........................................32
  182.       Subscription Screens ..............................................33
  183.       Unwanted Files Screen .............................................33
  184.       Language Menu Screen ..............................................33
  185.       External Chat Screens .............................................33
  186.       RIPscrip Borders For ANSI and ASCII Screens .......................34
  187.       Making Your Own Display Screens ...................................34
  188.  
  189.      SETTING UP A DOOR...................................................35
  190.       Enabling The Door Menu ............................................35
  191.       Setting Up TestDoor ...............................................36
  192.       Advice About Doors ................................................37
  193.       Support For Doors .................................................38
  194.  
  195.      EXTENDED MENU COMMANDS..............................................39
  196.  
  197.      CREATING A QUESTIONNAIRE............................................41
  198.  
  199.      MULTILANGUAGE SUPPORT...............................................43
  200.  
  201.      SPECIAL BATCH FILES.................................................44
  202.       ATTACH.BAT ........................................................44
  203.       BETWEEN.BAT .......................................................44
  204.       CHAT.BAT ..........................................................44
  205.       DOWNLOAD.BAT ......................................................44
  206.       EDITOR.BAT ........................................................45
  207.       FASTLOG.BAT .......................................................45
  208.       GOODBYE.BAT .......................................................45
  209.       LOGON.BAT .........................................................45
  210.       NDLOGON.BAT .......................................................45
  211.       NEWUSER.BAT .......................................................45
  212.       PAGE.BAT ..........................................................46
  213.       SECn.BAT ..........................................................46
  214.       UPLOAD.BAT ........................................................46
  215.  
  216.      FILE LISTS..........................................................47
  217.       FileMan ...........................................................47
  218.       MakeIdx ...........................................................48
  219.       Master ............................................................49
  220.       AscToBin ..........................................................49
  221.       List Converter ....................................................51
  222.       Running List Converter ............................................51
  223.  
  224.  
  225.  
  226.  
  227.  
  228.      TriBBS Bulletin Board System                                       iii
  229.  
  230.       Notes About List Converter ........................................51
  231.       User-Defined Templates ............................................51
  232.       Offline File Areas ................................................52
  233.       Putting Requested Files Online ....................................52
  234.  
  235.      EXTERNAL PROTOCOLS..................................................53
  236.       Send Batch Files ..................................................53
  237.       Receive Batch Files ...............................................54
  238.  
  239.      FILE RATIOS.........................................................55
  240.       File/Byte Ratios (Security Level Stays the Same) ..................55
  241.       File/Byte Ratios (Adjusting Security Levels) ......................55
  242.       Free Downloads ....................................................56
  243.  
  244.      SUBSCRIPTION SYSTEM.................................................57
  245.  
  246.      RUNNING TRIBBS WITH A FRONTEND OR AS A DOOR.........................58
  247.       Error Correcting Connections ......................................59
  248.       Limiting Time .....................................................59
  249.       Forced Hang Up ....................................................59
  250.  
  251.      ODDS AND ENDS.......................................................60
  252.       Multidisc CD-ROM Drives ...........................................60
  253.       DSZLOG Logging ....................................................60
  254.       Quick Logon .......................................................61
  255.       File Flagging .....................................................62
  256.       Packing the Message Base ..........................................62
  257.       The TriBBS Protocol Driver: TTPROT.EXE ............................63
  258.       Multitasker Awareness .............................................63
  259.       Archive Testing ...................................................63
  260.       Fossil Driver Support .............................................63
  261.       Caller ID Support .................................................64
  262.  
  263.      MULTINODES..........................................................65
  264.       Doors and Multinodes ..............................................66
  265.       Some Helpful Hints ................................................66
  266.       Multinode Chatting ................................................67
  267.  
  268.      HIGH-SPEED MODEMS...................................................68
  269.  
  270.      SUPPORT.............................................................70
  271.  
  272.      REGISTRATION........................................................71
  273.  
  274.      FREQUENTLY ASKED QUESTIONS..........................................72
  275.  
  276.  
  277.  
  278.  
  279.  
  280.      TriBBS Bulletin Board System                                        iv
  281.  
  282.  
  283.  
  284.  
  285.  
  286.      TriBBS Bulletin Board System                                         1
  287.  
  288.                                   INTRODUCTION
  289.                                   ------------
  290.  
  291.      TriBBS is one of the most successful shareware Bulletin Board  Systems
  292.      around. Although TriBBS is a shareware program, it comes equipped with
  293.      many powerful  features.   Some of  which aren't  found in  much  more
  294.      expensive commercial programs.
  295.  
  296.           Multinode Support - Although TriBBS  10.1 is an excellent  single
  297.           line  bulletin  board   system,  it   fully  supports   multinode
  298.           operation.  Unlike many other bulletin board systems, you do  not
  299.           have to pay extra for a multinode system.  So when your board  is
  300.           ready to expand,  TriBBS will easily  grow along with  you at  no
  301.           additional cost.
  302.  
  303.           Multinode Chat - On multinode  boards, TriBBS supports both  node
  304.           to node chatting and group chats.
  305.  
  306.           RIPscrip Graphics Support -  TriBBS supports RIPscrip graphics.  
  307.           RIPscrip graphics is the  defacto standard for graphics  terminal
  308.           emulation and by  supporting RIPscrip graphics,  TriBBS stays  on
  309.           the leading edge of BBS software.  TriBBS/Pro optionally supports
  310.           fulltime local RIPscrip graphics.
  311.  
  312.           Zmodem - TriBBS was  one of the first  bulletin board systems  to
  313.           offer Zmodem built right in.  There are still many bulletin board
  314.           systems that require you  to add an  external protocol driver  to
  315.           add Zmodem to you board.
  316.  
  317.           Full Screen Editor  - In addition  to an  excellent line  editor,
  318.           TriBBS features a  complete full  screen editor  to make  message
  319.           entry as easy as possible.
  320.  
  321.           Alias Support - TriBBS optionally supports the use of aliases  in
  322.           message conferences and file areas.
  323.  
  324.           Net Mail  - TriBBS's  message base  structure provides  extensive
  325.           support  for  net  mail  conferences.    Netmail  converters  are
  326.           available for Fido<->TriBBS, PCRelay<->TriBBS, Postlink<->TriBBS,
  327.           and QWK<->TriBBS.  Although these converters are an optional part
  328.           of TriBBS and not included in the TriBBS archive, they a  readily
  329.           available for download on any TriBBS support board.
  330.  
  331.           Doors - TriBBS can internally generate the door data files to run
  332.           most PCBoard, GAP (DOOR.SYS), Spitfire, WildCat, and RBBS  doors.
  333.           By supporting these five major  standards, TriBBS can run  pretty
  334.           much any  door  program.   By  generating  the  door  data  files
  335.           internally,  TriBBS  relieves  the   sysop  from  setting  up   a
  336.           collection of door data file conversion utilities.
  337.  
  338.           Archive Testing - TriBBS allows  you to optionally test  all
  339.           uploaded archives,  EXEs,  and  COMs to  see  if  they  were
  340.  
  341.  
  342.  
  343.  
  344.  
  345.      TriBBS Bulletin Board System                                         2
  346.  
  347.           uploaded without error and scan them for viruses.
  348.  
  349.           File Area Indexing - TriBBS allows you to optionally index  large
  350.           file areas, including CD-ROM file  areas, for quick location  and
  351.           retrieval of files on large file-oriented systems.
  352.  
  353.           Extensive CD-ROM Support - TriBBS  provides what is probably  the
  354.           best support for CD-ROMs  of any BBS  software.  TriBBS  supports
  355.           multiple directories  for each  file area.   Thus,  similar  file
  356.           directories  on  multiple  ROMs  and  the  hard  drives  can   be
  357.           consolidated into  a  single file  area.   TriBBS  also  provides
  358.           multinode support for CD-ROM drives that allow multiple CDs to be
  359.           read with only one read/write head.  TriBBS/Pro provides  support
  360.           for offline file areas.
  361.  
  362.           Fast Text Searching Through File Lists  - TriBBS has perhaps  the
  363.           fastest text searching through file lists  of any BBS software.  
  364.           Your callers will appreciate this feature because they won't have
  365.           to wait for  the BBS  software to  crawl through  the file  lists
  366.           searching for matches.
  367.  
  368.      One of  TriBBS's  chief  design goals  is  ease  of  installation  and
  369.      maintenance.  Some of  the above listed features,  such as Zmodem  and
  370.      internal generation of door data files, have already pointed out  some
  371.      of the reasons why TriBBS  is so easy to  use.  Other TriBBS  features
  372.      include generation of security level specific menu screens on the  fly
  373.      and the  ability to  run an  almost unlimited  number of  sliding  and
  374.      nonsliding events.  Overall, you should  find TriBBS to be one of  the
  375.      easiest bulletin board systems to set up and maintain.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.      TriBBS Bulletin Board System                                         3
  382.  
  383.                                   REQUIREMENTS
  384.                                   ------------
  385.  
  386.      TriBBS requires an IBM PC or compatible computer with  640K of memory,
  387.      a modem, and a hard disk drive.   Although TriBBS doesn't use 640K  of
  388.      memory itself, such programs as external protocol drivers, compression
  389.      utilities, etc. all  have their own  RAM requirements; therefore,  the
  390.      more memory the BBS has to run in the better.
  391.  
  392.  
  393.  
  394.  
  395.  
  396.      TriBBS Bulletin Board System                                         4
  397.  
  398.                                   INSTALLATION
  399.                                   ------------
  400.  
  401.      The first step in using  any computer program is  to install it.   You
  402.      probably acquired your copy of TriBBS from a BBS or online service and
  403.      have obviously uncompressed the file archive.   There are two  methods
  404.      for installing  TriBBS: automatic  installation through  the  included
  405.      INSTALL.EXE program or manual installation where you will be  required
  406.      to do most of the work yourself.  The method you chose is obviously up
  407.      to you, but most users will find automatic installation to be the best
  408.      method for setting up a new TriBBS board.
  409.  
  410.      Automatic Installation
  411.      ----------------------
  412.  
  413.      Automatic installation is started by running the INSTALL.EXE  program.
  414.      This is done by entering the following at the DOS prompt:
  415.  
  416.      INSTALL
  417.  
  418.      INSTALL starts  by displaying  a list  of  directories it  intends  to
  419.      create.   The  following  diagram  illustrates  the  directories  that
  420.      INSTALL creates by default.
  421.  
  422.      +--------------------------------------------------------------------+
  423.      |C:\                                                                 |
  424.      | |                                                                  |
  425.      | +---TRIBBS - Holds a few key data files, batch files to run        |
  426.      |      |       doors, batch files to run events, batch files to      |
  427.      |      |       run external protocol drivers, and more.              |
  428.      |      |                                                             |
  429.      |      +---BATCH    - Optionally, holds the batch files for doors,   |
  430.      |      |              events, etc.                                   |
  431.      |      |                                                             |
  432.      |      +---ICONS    - Holds any RIPscrip icons.                      |
  433.      |      |                                                             |
  434.      |      +---MWORK    - Holds the user data files, the message         |
  435.      |      |              conferences, questionnaires, answers to        |
  436.      |      |              questionnaires, the callers log, and a number  |
  437.      |      |              of other important data files.                 |
  438.      |      |                                                             |
  439.      |      +---NWORK    - Holds the menu configuration files, event data |
  440.      |      |              files, and temporary callers log.              |
  441.      |      |                                                             |
  442.      |      +---DISPLAY  - Holds display screens: log on screens, goodbye |
  443.      |      |              screen, bulletins, door bulletins, custom menu |
  444.      |      |              screens, etc.                                  |
  445.      |      |                                                             |
  446.      |      +---TRANSFER - Used by TriBBS to hold temporary files during  |
  447.      |      |              file transfers.                                |
  448.      |      |                                                             |
  449.      |      +---TTTEMP   - Used by TriBBS to hold transient files and     |
  450.  
  451.  
  452.  
  453.  
  454.  
  455.      TriBBS Bulletin Board System                                         5
  456.  
  457.      |                     data.                                          |
  458.      +--------------------------------------------------------------------+
  459.  
  460.      You can change the  main BBS directory by  pressing the <F10> key  and
  461.      entering the new main BBS directory's name. 
  462.  
  463.      The installation process will continue as soon as you press <ENTER>.  
  464.      The  installation  program  continues  by  creating  the  eight  above
  465.      mentioned  directories  and   copying  a  number   of  files  to   the
  466.      directories.
  467.  
  468.      At this point the installation program  will halt and wait for you  to
  469.      enter the BBS name (default: Unnamed BBS), the sysop's name  (default:
  470.      Joe Sysop), the com port (default:  1), and your modem's maximum  baud
  471.      rate (default:  2400).   Once you  have  edited these  to  appropriate
  472.      values, you must press <F10> to continue.
  473.  
  474.      The automatic installation  process should  now be  complete and  your
  475.      directories should  look  like the  ones  presented in  the  following
  476.      diagram.
  477.  
  478.      +--------------------------------------------------------------------+
  479.      |C:\                                                                 |
  480.      | |                                                                  |
  481.      | +---TRIBBS        - BBS.EXE      - This is the main TriBBS program |
  482.      |      |                             file.                           |
  483.      |      |            - TRIBBS.DOC   - This manual.                    |
  484.      |      |            - REGISTER.DOC - Use this form to register your  |
  485.      |      |                             BBS.                            |
  486.      |      |            - TTPROT.EXE   - This is the TriBBS protocol     |
  487.      |      |                             driver.                         |
  488.      |      |            - FTTPROT.EXE  - This is the fossil driver       |
  489.      |      |                             version of the TriBBS protocol  |
  490.      |      |                             driver.                         |
  491.      |      |            - FILEMAN.EXE  - This is the TriBBS file area    |
  492.      |      |                             manager.                        |
  493.      |      |            - FMAN32.EXE   - This is a 32-bit version of     |
  494.      |      |                             FileMan.  You must have a 386   |
  495.      |      |                             or better to run this program.  |
  496.      |      |            - FILEMAN.HLP  - This is the help file for       |
  497.      |      |                             FILEMAN.EXE and FMAN32.EXE      |
  498.      |      |            - TRIPACK.EXE  - This is the TriBBS message base |
  499.      |      |                             packer.                         |
  500.      |      |            - TRIMAN.EXE   - This is the TriBBS manager.  It |
  501.      |      |                             allows you to configure your    |
  502.      |      |                             BBS.                            |
  503.      |      |            - TRIMAN.HLP   - This is the help file for       |
  504.      |      |                             TRIMAN.EXE.                     |
  505.      |      |            - MAKEIDX.EXE  - This is the file area index     |
  506.      |      |                             file generator.  (This program  |
  507.      |      |                             is not used by all systems.)    |
  508.      |      |            - ASCTOBIN.EXE - This program is used to convert |
  509.  
  510.  
  511.  
  512.  
  513.  
  514.      TriBBS Bulletin Board System                                         6
  515.  
  516.      |      |                             text file listings to the binary|
  517.      |      |                             format that TriBBS uses.  (This |
  518.      |      |                             program is not used by all      |
  519.      |      |                             systems.)                       |
  520.      |      |            - FL51TO10.EXE - This program will convert TriBBS|
  521.      |      |                             5.1x file lists to the TriBBS   |
  522.      |      |                             10.1 file list format.          |
  523.      |      |            - NEWLANGS.EXE - This program will convert       |
  524.      |      |                             pre-10.1 language files to the  |
  525.      |      |                             10.1 format.                    |
  526.      |      |            - LISTCVT.EXE  - This program is used to convert |
  527.      |      |                             non-TriBBS file lists to the    |
  528.      |      |                             TriBBS file list format. This is|
  529.      |      |                             TriBBS/Pro program only.        |
  530.      |      |            - LISTCVT.HLP  - This is the help file for       |
  531.      |      |                             LISTCVT.EXE.                    |
  532.      |      |            - MASTER.EXE   - This program is used to generate|
  533.      |      |                             a master file index. (This      |
  534.      |      |                             program is not used by all      |
  535.      |      |                             systems and is a TriBBS/Pro     |
  536.      |      |                             program only.)                  |
  537.      |      |            - REQUEST.EXE  - This program is used to put     |
  538.      |      |                             offline files online.  This is a|
  539.      |      |                             TriBBS/Pro program only.        |
  540.      |      |            - TEMPLATE.TXT - Template file for ListCvt.      |
  541.      |      |            - TESTDOOR.EXE - This is a sample door program.  |
  542.      |      |            - EGAVGA.BGI   - Graphics driver.                |
  543.      |      |            - BOLD.CHR     - Graphics font file.             |
  544.      |      |            - EURO.CHR     - Graphics font file.             |
  545.      |      |            - GOTH.CHR     - Graphics font file.             |
  546.      |      |            - LCOM.CHR     - Graphics font file.             |
  547.      |      |            - LITT.CHR     - Graphics font file.             |
  548.      |      |            - SANS.CHR     - Graphics font file.             |
  549.      |      |            - SCRI.CHR     - Graphics font file.             |
  550.      |      |            - SIMP.CHR     - Graphics font file.             |
  551.      |      |            - TRIP.CHR     - Graphics font file.             |
  552.      |      |            - TSCR.CHR     - Graphics font file.             |
  553.      |      |            - TRIRIP.FNT   - Graphics font file.             |
  554.      |      |            - BOARD.BAT    - This is the batch file that is  |
  555.      |      |                             used to start the BBS running.  |
  556.      |      |            - SYSDAT1.DAT  - This is the key system data     |
  557.      |      |                             file.                           |
  558.      |      |            - SYSDAT2.DAT  - This file is used to point all  |
  559.      |      |                             nodes to the proper drive and   |
  560.      |      |                             directories.                    |
  561.      |      |            - NODE.DAT     - This file holds the node        |
  562.      |      |                             specific information.           |
  563.      |      |                                                             |
  564.      |      +---BATCH                                                     |
  565.      |      |                                                             |
  566.      |      +---ICONS                                                     |
  567.      |      |                                                             |
  568.  
  569.  
  570.  
  571.  
  572.  
  573.      TriBBS Bulletin Board System                                         7
  574.  
  575.      |      +---MWORK    - LANGUAGE.001 - This file contains all of       |
  576.      |      |                             text prompts that the caller    |
  577.      |      |                             sees while he is online.        |
  578.      |      |                                                             |
  579.      |      +---NWORK    - MAIN.MNU     - This is the main menu           |
  580.      |      |                             configuration file.             |
  581.      |      |            - FILES.MNU    - This is the file menu           |
  582.      |      |                             configuration file.             |
  583.      |      |            - MESSAGE.MNU  - This is the message menu        |
  584.      |      |                             configuration file.             |
  585.      |      |            - SYSOP.MNU    - This is the sysop menu          |
  586.      |      |                             configuration file.             |
  587.      |      |                                                             |
  588.      |      +---DISPLAY  - TCHAT.BBS    - This is the Telechat help       |
  589.      |      |                             screen.                         |
  590.      |      |            - FSCREEN.BBS  - This is the full-screen editor's|
  591.      |      |                             help screen.                    |
  592.      |      |                                                             |
  593.      |      +---TRANSFER                                                  |
  594.      |      |                                                             |
  595.      |      |                                                             |
  596.      |      +---TTTEMP                                                    |
  597.      |                                                                    |
  598.      +--------------------------------------------------------------------+
  599.  
  600.      You should now jump ahead to the section entitled "Getting TriBBS to  
  601.      Run on Boot Up".                                                      
  602.       
  603.      IMPORTANT: INSTALL.EXE  is only  designed  for installing  new  TriBBS
  604.      systems and should not  be used for installing  additional nodes on  a
  605.      multinode system or upgrading from a previous version of TriBBS.      
  606.       
  607.      Manual Installation
  608.      -------------------
  609.  
  610.      The first  step in  the manual  installation process  is to  create  a
  611.      TRIBBS subdirectory on your hard disk.   If your hard disk is your  C:
  612.      drive, you could do this by entering the following at the DOS  command
  613.      prompt:
  614.  
  615.      MD C:\TRIBBS
  616.  
  617.      Next you should copy all of the files that were included in the TriBBS
  618.      archive to this new subdirectory.   This can be accomplished with  the
  619.      following command:
  620.  
  621.      COPY *.* \TRIBBS
  622.  
  623.      Now you can delete the TriBBS archive files in your current  directory
  624.      by entering the following command:
  625.  
  626.      DEL *.*
  627.  
  628.  
  629.  
  630.  
  631.  
  632.      TriBBS Bulletin Board System                                         8
  633.  
  634.      IMPORTANT: Be sure  there aren't any  other non-TriBBS  files in  your
  635.      current directory before you  enter the above command.   If you  don't
  636.      check for other files, you  will lose them.   If there are other  non-
  637.      TriBBS files in your  current directory, you will  have to delete  the
  638.      TriBBS files one at a time.                                           
  639.       
  640.      The next step  is to change  to the newly  created TRIBBS directory.  
  641.      This can be done with the following command:
  642.  
  643.      CD \TRIBBS
  644.  
  645.      Now you  must  initialize  your TriBBS  system  by  running  the  file
  646.      BBS.EXE.   To do  this, you  simply  enter the  following at  the  DOS
  647.      prompt:
  648.  
  649.      BBS                                                                 
  650.  
  651.      IMPORTANT: If your modem uses another  port other than COM1, you  must
  652.      start TriBBS with the following command:
  653.  
  654.      BBS /Cport
  655.  
  656.      Where "port" is the number of your modem's serial port.  For  example,
  657.      a TriBBS system that  will be using  a modem hooked  up to COM2  would
  658.      need to be initialized with the following command:
  659.  
  660.      BBS /C2
  661.                                                                           
  662.      A local-only node can be created by  specifying a port number of 0  as
  663.      follows:
  664.  
  665.      BBS /C0
  666.  
  667.      By creating  a local-only  node, the  TriBBS  node doesn't  require  a
  668.      modem.  This can be very useful for setting up a node for the sysop to
  669.      perform daily maintenance on.  You should note that some doors may not
  670.      be useable with a local-only node.
  671.  
  672.      IMPORTANT: If your modem  can't support at least  2400 baud, you  must
  673.      start TriBBS with the following command:                              
  674.       
  675.      BBS /Bbaud
  676.  
  677.      Where "baud" is your modem's highest baud rate.  For example, a TriBBS
  678.      system that  will  be  using  a  1200 baud  modem  would  need  to  be
  679.      initialized with the following command:
  680.  
  681.      BBS /B1200
  682.  
  683.      You can of course combine  the /C and /B  command line switches.   For
  684.      example, a system with  a 300 baud (YUCK!!!)  modem hooked up to  COM3
  685.      would use one of the following commands:
  686.  
  687.  
  688.  
  689.  
  690.  
  691.      TriBBS Bulletin Board System                                         9
  692.  
  693.      BBS /C3 /B300  or BBS /B300 /C3
  694.  
  695.      If everything went ok, you should now see TriBBS's Waiting for  Caller
  696.      screen.  This screen presents you with 12 menu options.  At this time,
  697.      you should  use the  arrow keys  to  move to  the "Exit  TriBBS"  push
  698.      button.  Once  the "Exit TriBBS"  push button  is highlighted,  simply
  699.      press <ENTER>  (For  the  rest  of this  manual,  a  keyboard  key  is
  700.      indicated by surrounding it with <>.) and you will be returned to  the
  701.      DOS prompt. 
  702.  
  703.      By running TriBBS in this fashion, TriBBS has created two system  data
  704.      files (SYSDAT1.DAT and SYSDAT2.DAT), a node data file (NODE.DAT),  and
  705.      five subdirectories off your main  TriBBS directory.  The  directories
  706.      that TriBBS created should look like the following:
  707.  
  708.      +--------------------------------------------------------------------+
  709.      |C:\                                                                 |
  710.      | |                                                                  |
  711.      | +---TRIBBS - Holds a few key data files, batch files to run        |
  712.      |      |       doors, batch files to run events, batch files to      |
  713.      |      |       run external protocol drivers, and more.              |
  714.      |      |                                                             |
  715.      |      +---BATCH    - Optionally, holds the batch files for doors,   |
  716.      |      |              events, etc.                                   |
  717.      |      |                                                             |
  718.      |      +---ICONS    - Holds any RIPscrip icons.                      |
  719.      |      |                                                             |
  720.      |      +---MWORK    - Holds the user data files, the message         |
  721.      |      |              conferences, questionnaires, answers to        |
  722.      |      |              questionnaires, the callers log, and a number  |
  723.      |      |              of other important data files.                 |
  724.      |      |                                                             |
  725.      |      +---NWORK    - Holds the menu configuration files, event data |
  726.      |      |              files, and temporary callers log.              |
  727.      |      |                                                             |
  728.      |      +---DISPLAY  - Holds display screens: log on screens, goodbye |
  729.      |      |              screen, bulletins, door bulletins, custom menu |
  730.      |      |              screens, etc.                                  |
  731.      |      |                                                             |
  732.      |      +---TRANSFER - Used by TriBBS to hold temporary files during  |
  733.      |      |              file transfers.                                |
  734.      |      |                                                             |
  735.      |      +---TTTEMP   - Used by TriBBS to hold transient files and     |
  736.      |                     data.                                          |
  737.      +--------------------------------------------------------------------+
  738.  
  739.      The Menu Configuration Files
  740.      ----------------------------
  741.  
  742.      TriBBS uses  a series  of menu  configuration files  to generate  menu
  743.      displays on the  fly.   If you  do a  directory listing  of your  main
  744.      TriBBS directory, you  will note  that TriBBS  came with  a number  of
  745.  
  746.  
  747.  
  748.  
  749.  
  750.      TriBBS Bulletin Board System                                        10
  751.  
  752.      files with the  extension of MNU.   These are  the menu  configuration
  753.      files and must  be placed  in your  NWORK subdirectory  for TriBBS  to
  754.      function properly.  Moving these files  to the NWORK subdirectory  and
  755.      deleting them from the main TriBBS directory can be accomplished  with
  756.      the following two commands:
  757.  
  758.      COPY *.MNU NWORK
  759.      DEL *.MNU
  760.  
  761.      The Help Display Screens
  762.      ------------------------
  763.  
  764.      Included in the TriBBS archive are a couple of help screens which must
  765.      be moved into your  DISPLAY subdirectory.  Moving  these files to  the
  766.      DISPLAY subdirectory and deleting them from the main TriBBS  directory
  767.      can be accomplished with the following two commands:
  768.  
  769.      COPY *.BBS DISPLAY
  770.      DEL *.BBS
  771.  
  772.      The Default Language File
  773.      -------------------------
  774.  
  775.      Included  in  the  TriBBS  archive  is  the  default  language   file,
  776.      LANGUAGE.001.  You need to copy this file into your MWORK directory as
  777.      follows:
  778.  
  779.      COPY LANGUAGE.001 MWORK
  780.      DEL LANGUAGE.001
  781.  
  782.      Modifying BOARD.BAT
  783.      -------------------
  784.  
  785.      The next step in getting a minimal TriBBS system up and running is  to
  786.      make any necessary modifications  to a batch  file called BOARD.BAT.  
  787.      Although TriBBS  will  run by  simply  executing BBS.EXE  at  the  DOS
  788.      prompt, it will  not be  able to run  events and  doors without  being
  789.      executed by BOARD.BAT.  Consequently, you should always start up  your
  790.      BBS by entering the following at the DOS prompt:
  791.                        
  792.      BOARD
  793.  
  794.      As we said though, BOARD.BAT may  need to be modified.  The  following
  795.      is a listing of BOARD.BAT:
  796.  
  797.  
  798.  
  799.  
  800.  
  801.      TriBBS Bulletin Board System                                        11
  802.  
  803.      +--------------------------------------------------------------------+
  804.      |echo off                                                            |
  805.      |cd \tribbs                                                          |
  806.      |if exist door.bat del door.bat                                      |
  807.      |if exist event.bat del event.bat                                    |
  808.      |if exist endbbs del endbbs                                          |
  809.      |bbs                                                                 |
  810.      |if exist door.bat door                                              |
  811.      |if exist event.bat event                                            |
  812.      |if exist endbbs goto end                                            |
  813.      |board                                                               |
  814.      |:end                                                                |
  815.      +--------------------------------------------------------------------+
  816.  
  817.      Note how the second line of BOARD.BAT changes the current directory to
  818.      the TriBBS's main directory.   If your TriBBS  setup uses a  different
  819.      directory other than "\TRIBBS", you will have to use a text editor  to
  820.      make the appropriate change.
  821.  
  822.      Getting TriBBS to Run on Boot Up
  823.      --------------------------------
  824.  
  825.      You will want your  TriBBS system to  automatically start up  whenever
  826.      your computer reboots.   This can  be accomplished  by performing  two
  827.      simple modifications to  your AUTOEXEC.BAT file.   First  of all,  you
  828.      should modify or  create a SET  PATH or PATH  command to include  your
  829.      main TriBBS directory.   At  the end  of your  AUTOEXEC.BAT file,  you
  830.      should put the  command BOARD.   That way DOS  will automatically  run
  831.      TriBBS each time the computer is rebooted.  The following is a  sample
  832.      AUTOEXEC.BAT file before it has  been modified to automatically  start
  833.      up TriBBS:
  834.  
  835.      +--------------------------------------------------------------------+
  836.      |@ECHO OFF                                                           |
  837.      |PROMPT $p$g                                                         |
  838.      |PATH C:\DOS;C:\WINDOWS;C:\QEMM;C:\ZIP                               |
  839.      +--------------------------------------------------------------------+
  840.  
  841.      The following  is the  same AUTOEXEC.BAT  file after  the  appropriate
  842.      changes have been made to it for TriBBS:
  843.  
  844.      +--------------------------------------------------------------------+
  845.      |@ECHO OFF                                                           |
  846.      |PROMPT $p$g                                                         |
  847.      |PATH C:\TRIBBS;C:\DOS;C:\WINDOWS;C:\QEMM;C:\ZIP                     |
  848.      |BOARD                                                               |
  849.      +--------------------------------------------------------------------+
  850.  
  851.      Note how the PATH command in line three was modified and how BOARD was
  852.      added to the end of the batch file.
  853.  
  854.      IMPORTANT: Starting  with  version  2.1,  TriBBS  uses  TTPROT.EXE  to
  855.  
  856.  
  857.  
  858.  
  859.  
  860.      TriBBS Bulletin Board System                                        12
  861.  
  862.      perform file transfers.  TTPROT is included  with TriBBS  and must  be
  863.      placed in either your main TriBBS directory or a directory that is  in
  864.      your DOS PATH statement.
  865.  
  866.      If  everything  has  been  done  properly,  TriBBS  should  start   up
  867.      automatically after a reboot.  So let's give it a try and press RESET.
  868.      After a few  seconds, you  should see  the TriBBS  Waiting for  Caller
  869.      screen.  If you don't, you should go back and check both BOARD.BAT and
  870.      AUTOEXEC.BAT for errors.  It will probably be something really simple.
  871.  
  872.      Your First Log On
  873.      -----------------
  874.  
  875.      You can now finally log on as a new  user.  Simply enter BOARD at  the
  876.      DOS prompt to  restart TriBBS.   After the Waiting  for Caller  screen
  877.      appears and the modem has been initialized, move to the "Local  Logon"
  878.      push button and select it by  pressing <ENTER>.  This option will  log
  879.      you on to the BBS and takes the phone off the hook.  The screen should
  880.      now clear and the following will be displayed:
  881.  
  882.      +--------------------------------------------------------------------+
  883.      |CONNECT LOCAL / 12-27-95 (10:40)                                    |
  884.      |                                                                    |
  885.      |Welcome to Unnamed BBS - Node 1.                                    |
  886.      |A TriBBS (R) 10.1 Bulletin Board System                             |
  887.      |                                                                    |
  888.      |Copyright (c) 1991-1997 By Freejack's Software                      |
  889.      |Your Sysop is Joe Sysop.                                            |
  890.      |Test Drive Version!                                                 |
  891.      |                                                                    |
  892.      |                                                                    |
  893.      |Do you want ANSI color graphics (Y/n)?                              |
  894.      +--------------------------------------------------------------------+
  895.  
  896.      This display simply  displays that a  local connection  was made,  the
  897.      name of the board,  Unnamed BBS, and node  number; that it's a  TriBBS
  898.      10.1 BBS; a copyright notice; the sysop's name, Joe Sysop; and it's  a
  899.      "Test Drive  Version!" of  the software.   The  board's name  and  the
  900.      sysop's name can be changed quite simply.  We'll discuss how it's done
  901.      in the next  section.  As  for a registration  number, you'll have  to
  902.      register your board to get rid of "Test Drive Version!".
  903.  
  904.      Important: Until  TriBBS  is  registered,  you  are  limited  to  five
  905.      messages conferences, five file areas, and five doors.
  906.  
  907.      You will also note that TriBBS is  prompting you as to whether or  not
  908.      you want ANSI color graphics or not.  If you have a color monitor, you
  909.      will probably want to respond affirmatively by pressing either <Y>  or
  910.      the <ENTER> key.  If you don't have a color monitor or just simply  do
  911.      not want a color display, respond "No" by pressing <N>.  Note how  the
  912.      prompt has  the "Y"  capitalized.   This  indicates that  TriBBS  will
  913.      consider pressing <ENTER> as  the same as pressing  <Y>.  So  whenever
  914.  
  915.  
  916.  
  917.  
  918.  
  919.      TriBBS Bulletin Board System                                        13
  920.  
  921.      you see a similar TriBBS prompt,  you will know that pressing  <ENTER>
  922.      will perform the same action as pressing the capitalized key.
  923.  
  924.      After selecting the appropriate color  choice, TriBBS will prompt  you
  925.      to enter your name as follows:
  926.  
  927.      +--------------------------------------------------------------------+
  928.      |Enter your FIRST and LAST name:                                     |
  929.      +--------------------------------------------------------------------+
  930.  
  931.      Simply type your name and press  <ENTER>.  Because this is your  first
  932.      log on, TriBBS will display the following:
  933.  
  934.      +--------------------------------------------------------------------+
  935.      |Enter your FIRST and LAST name: Gary Price                          |
  936.      |Searching user records for Gary Price.                              |
  937.      |<G>oodbye, <R>eenter name, or <N>ew User?                           |
  938.      +--------------------------------------------------------------------+
  939.  
  940.      Because you are a "new user", you should press <N>.  If you weren't  a
  941.      new user,  you could  either "reenter  name" by  pressing <R>  or  say
  942.      "goodbye" by pressing <G>.
  943.  
  944.      TriBBS will now prompt you for a password as follows:
  945.  
  946.      +--------------------------------------------------------------------+
  947.      |Enter your password (1 to 15 chars.):                               |
  948.      +--------------------------------------------------------------------+
  949.  
  950.      Simply type in a password and press <ENTER>.
  951.  
  952.      IMPORTANT: Be sure that you use a unique password for your system.  If
  953.      somebody finds out what your password  is, it is possible for them  to
  954.      make extensive modifications  to your BBS.   So be  careful with  your
  955.      password.
  956.  
  957.      TriBBS will now ask you to re-enter your password as follows:        
  958.  
  959.      +--------------------------------------------------------------------+
  960.      |Please select a password (1 to 15 chars.): .......                  |
  961.      |Please reenter the password:                                        |
  962.      +--------------------------------------------------------------------+
  963.  
  964.      Simply re-enter your password.   The main reason  for allowing you  to
  965.      reenter a password  is because  a remote user  may get  hit with  line
  966.      noise and  not  realize  that  his  desired  password  wasn't  entered
  967.      properly.
  968.  
  969.      After entering your password  correctly, TriBBS will  prompt you for  
  970.      the first line of your street address as follows:
  971.  
  972.  
  973.  
  974.  
  975.  
  976.      TriBBS Bulletin Board System                                        14
  977.  
  978.      +--------------------------------------------------------------------+
  979.      |Enter your street address (line 1):                                 |
  980.      +--------------------------------------------------------------------+
  981.  
  982.      After entering the first line of your street address, TriBBS will give
  983.      you the opportunity to change it as follows:
  984.  
  985.      +--------------------------------------------------------------------+
  986.      |Enter your street address (line 1): 366 14th St                     |
  987.      |Is 366 14th St correct (Y,n)?                                       |
  988.      +--------------------------------------------------------------------+
  989.  
  990.      TriBBS continues by asking for the second line of your street  address
  991.      as follows:
  992.  
  993.      +--------------------------------------------------------------------+
  994.      |Enter your street address (line 2):                                 |
  995.      +--------------------------------------------------------------------+
  996.  
  997.      After entering the  second line of  your street  address, TriBBS  will
  998.      give you the opportunity to change it as follows:
  999.  
  1000.      +--------------------------------------------------------------------+
  1001.      |Enter your street address (line 2): PO Box 0                        |
  1002.      |Is Po Box 0 correct (Y,n)?                                          |
  1003.      +--------------------------------------------------------------------+
  1004.  
  1005.      TriBBS continues by asking for your city as follows:
  1006.  
  1007.      +--------------------------------------------------------------------+
  1008.      |Enter your City:                                                    |
  1009.      +--------------------------------------------------------------------+
  1010.  
  1011.      After entering  your city,  TriBBS will  give you  the opportunity  to
  1012.      change it as follows:
  1013.  
  1014.      +--------------------------------------------------------------------+
  1015.      |Enter your City: Bangor                                             |
  1016.      |Is Bangor correct (Y,n)?                                            |
  1017.      +--------------------------------------------------------------------+
  1018.  
  1019.      TriBBS continues by asking for your state as follows:
  1020.  
  1021.      +--------------------------------------------------------------------+
  1022.      |Enter your state:                                                   |
  1023.      +--------------------------------------------------------------------+
  1024.  
  1025.      After entering your  state, TriBBS will  give you  the opportunity  to
  1026.      change it as follows:
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.      TriBBS Bulletin Board System                                        15
  1033.  
  1034.      +--------------------------------------------------------------------+
  1035.      |Enter your state: Me                                                |
  1036.      |Is Me correct (Y,n)?                                                |
  1037.      +--------------------------------------------------------------------+
  1038.  
  1039.      TriBBS continues by asking for your zip code as follows:
  1040.  
  1041.      +--------------------------------------------------------------------+
  1042.      |Enter your zip code:                                                |
  1043.      +--------------------------------------------------------------------+
  1044.  
  1045.      After entering your zip code, TriBBS will give you the opportunity  to
  1046.      change it as follows:
  1047.  
  1048.      +--------------------------------------------------------------------+
  1049.      |Enter your zip code: 04401                                          |
  1050.      |Is 04401 correct (Y,n)?                                             |
  1051.      +--------------------------------------------------------------------+
  1052.  
  1053.      TriBBS continues by asking for your country as follows:
  1054.  
  1055.      +--------------------------------------------------------------------+
  1056.      |Enter your country (ENTER for USA):                                 |
  1057.      +--------------------------------------------------------------------+
  1058.  
  1059.      After entering your country, TriBBS will  give you the opportunity  to
  1060.      change it as follows:
  1061.  
  1062.      +--------------------------------------------------------------------+
  1063.      |Enter your country (ENTER for USA):                                 |
  1064.      |Is Usa correct (Y,n)?                                               |
  1065.      +--------------------------------------------------------------------+
  1066.  
  1067.      TriBBS continues by asking for your phone number as follows:
  1068.  
  1069.      +--------------------------------------------------------------------+
  1070.      |Enter your phone number ###-###-####:                               |
  1071.      +--------------------------------------------------------------------+
  1072.  
  1073.      After entering your phone number, TriBBS will give you the opportunity
  1074.      to change it as follows:
  1075.  
  1076.      +--------------------------------------------------------------------+
  1077.      |Enter your phone number ###-###-####: 207-990-0565                  |
  1078.      |Is 207-990-0565 correct (Y,n)?                                      |
  1079.      +--------------------------------------------------------------------+
  1080.  
  1081.      TriBBS continues by asking for your date of birth as follows:
  1082.  
  1083.      +--------------------------------------------------------------------+
  1084.      |Enter your date of birth MM/DD/YY:                                  |
  1085.      +--------------------------------------------------------------------+
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.      TriBBS Bulletin Board System                                        16
  1092.  
  1093.  
  1094.      After  entering  your  date  of  birth,  TriBBS  will  give  you   the
  1095.      opportunity to change it as follows:
  1096.  
  1097.      +--------------------------------------------------------------------+
  1098.      |Enter your date of birth MM/DD/YY: 10/19/56                         |
  1099.      |Is 10/19/56 correct (Y,n)?                                          |
  1100.      +--------------------------------------------------------------------+
  1101.  
  1102.      TriBBS continues  by  asking  you to  select  a  default  protocol  as
  1103.      follows:
  1104.  
  1105.      +--------------------------------------------------------------------+
  1106.      |<A> Ascii                                                           |
  1107.      |<X> Xmodem                                                          |
  1108.      |<K> Xmodem-1K                                                       |
  1109.      |<Y> Ymodem                                                          |
  1110.      |<G> Ymodem-G                                                        |
  1111.      |<Z> Zmodem                                                          |
  1112.      |<N> No Default                                                      |
  1113.      |                                                                    |
  1114.      |Please select a default protocol:                                   |
  1115.      +--------------------------------------------------------------------+
  1116.  
  1117.      Simply select the default file transfer protocol you would like to use
  1118.      when calling your board remotely.  If you don't want to set a  default
  1119.      protocol, press <N>.   By selecting "No  Default", TriBBS will  prompt
  1120.      you to select a protocol before each file transfer.
  1121.  
  1122.      After selecting a default protocol, TriBBS will prompt you to select a
  1123.      default editor as follows:
  1124.  
  1125.      +--------------------------------------------------------------------+
  1126.      |<L> Line Editor                                                     |
  1127.      |<F> Full Screen Editor                                              |
  1128.      |<N> No Default                                                      |
  1129.      |                                                                    |
  1130.      |Please select a default editor:                                     |
  1131.      +--------------------------------------------------------------------+
  1132.  
  1133.      Simply select the default editor you would like to use.  By  selecting
  1134.      "No Default",  TriBBS  will prompt  you  to select  an  editor  before
  1135.      entering each message if you have ANSI graphics enabled.
  1136.  
  1137.      TriBBS will continue by displaying the board's main menu as follows:
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.      TriBBS Bulletin Board System                                        17
  1144.  
  1145.      +--------------------------------------------------------------------+
  1146.      |<B>..Bulletin Menu                 <Y>..Your Personal Information   |
  1147.      |<M>..Message Menu                  <I>..System Information          |
  1148.      |<F>..File Menu                     <U>..List of Users               |
  1149.      |<C>..Comment to Sysop              <X>..Expert Mode                 |
  1150.      |<A>..Toggle ANSI Graphics          <P>..Page Sysop                  |
  1151.      |<N>..Newsletter                    <G>..Goodbye                     |
  1152.      +--------------------------------------------------------------------+
  1153.  
  1154.      For the most part, TriBBS's main menu is its gateway to other areas of
  1155.      interest.  You will also see the following prompt:
  1156.  
  1157.      +--------------------------------------------------------------------+
  1158.      |You have been on 9 minutes with 51 remaining.                       |
  1159.      |Enter Selection - [B M F C A N Y I U X P G ?]?                      |
  1160.      +--------------------------------------------------------------------+
  1161.  
  1162.      At this point, you  will want to log  off your BBS  by pressing <G>.  
  1163.      Before logging off, TriBBS will give you a final chance to change your
  1164.      mind as follows:
  1165.  
  1166.      +--------------------------------------------------------------------+
  1167.      |Are you sure you want to log off (Y/n)?                             |
  1168.      +--------------------------------------------------------------------+
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.      TriBBS Bulletin Board System                                        18
  1175.  
  1176.                                THE TRIBBS MANAGER
  1177.                                ------------------
  1178.  
  1179.      The TriBBS Manager program, TriMan, is used to perform such actions as
  1180.      configuring the  system,  configuring the  node,  configuring  message
  1181.      conferences, configuring file areas, editing users, configuring menus,
  1182.      packing the  user file,  packing the  message base,  and more.   As  a
  1183.      sysop, TriMan will be  one of the most  important tools you'll use  in
  1184.      maintaining your BBS.
  1185.  
  1186.      To run TriMan, you must  be in your nodes's  main directory.  Then  at
  1187.      the DOS prompt enter TRIMAN.
  1188.  
  1189.      TriMan comes with an extensive amount of context sensitive help.   You
  1190.      can press  <F1>  at  anytime  while  running  TriMan  to  consult  the
  1191.      appropriate help screens.
  1192.  
  1193.      TriMan Odds and Ends
  1194.      --------------------
  1195.  
  1196.      TriMan can be called with the following command line switches:
  1197.  
  1198.      +--------------------------------------------------------------------+
  1199.      |Switch(es)              Action                                      |
  1200.      +--------------------------------------------------------------------+
  1201.      |/SYSTEM                 Runs TriMan's system editor.                |
  1202.      |/NODE                   Runs TriMan's node editor.                  |
  1203.      |/USERS                  Runs TriMan's user editor.                  |
  1204.      |/CONF                   Runs TriMan's message conference editor.    |
  1205.      |/FILE                   Runs TriMan's file area editor.             |
  1206.      |/EVENT                  Runs TriMan's event editor.                 |
  1207.      |/UPACK                  Runs TriMan's user file packer and asks     |
  1208.      |                        before packing.                             |
  1209.      |/UPACK /BATCH           Unconditionally runs TriMan's user file     |
  1210.      |                        packer.                                     |
  1211.      |/MPACK                  Runs TriPack via TriMan.                    |
  1212.      +--------------------------------------------------------------------+
  1213.  
  1214.      IMPORTANT: You should be  very careful using  TriMan when somebody  is
  1215.      online.  About the only safe thing you can do while somebody is online
  1216.      is to edit  the user file.   You should  not attempt to  do any  other
  1217.      configuration with TriMan while anybody is on your BBS.  To do so, may
  1218.      lead to an irreversible corruption of your board's data files!
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.      TriBBS Bulletin Board System                                        19
  1225.  
  1226.  
  1227.                          THE WAITING FOR CALLER SCREEN
  1228.                          -----------------------------
  1229.  
  1230.      Other than being pretty colorful,  TriBBS's Waiting for Caller  screen
  1231.      allows the sysop to perform a great deal of board maintenance  without
  1232.      even having to log  on to the  board.  The  Waiting for Caller  screen
  1233.      performs these maintenance operations by calling TriMan.  The  Waiting
  1234.      for Caller screen is divided into four major parts. 
  1235.  
  1236.      The Waiting for Caller Screen Menu
  1237.      ----------------------------------
  1238.  
  1239.      The top  portion of  the screen  is the  Waiting for  Caller menu  and
  1240.      allows you to select one of the following 12 options:
  1241.  
  1242.      +--------------------------------------------------------------------+
  1243.      |Drop to DOS                                                         |
  1244.      |Configure Node                                                      |
  1245.      |Edit Conferences                                                    |
  1246.      |Local Logon                                                         |
  1247.      |Edit Users                                                          |
  1248.      |Edit Events                                                         |
  1249.      |Configure System                                                    |
  1250.      |Edit File Areas                                                     |
  1251.      |View Callers Log                                                    |
  1252.      |Pack User File                                                      |
  1253.      |Exit TriBBS                                                         |
  1254.      |Pack Message Base                                                   |
  1255.      +--------------------------------------------------------------------+
  1256.  
  1257.      As you already know from installing TriBBS, a menu option is  selected
  1258.      by moving to the desired push button with the arrow keys and  pressing
  1259.      <ENTER>.  Each of these 12 menu options will now be explained one at a
  1260.      time.
  1261.  
  1262.      Drop to DOS
  1263.      -----------
  1264.  
  1265.      The "Drop to DOS"  menu option will temporarily  shell out to DOS  and
  1266.      allow you to enter DOS commands.   You can return to TriBBS by  simply
  1267.      entering EXIT at the DOS command prompt.  You should note that  TriBBS
  1268.      takes the phone off  the hook when  the "Drop to  DOS" menu option  is
  1269.      selected and will put it back on the  hook when you return from DOS.  
  1270.      This will give any callers a BUSY signal while you are shelled out  to
  1271.      DOS.
  1272.  
  1273.      Configure Node
  1274.      ---------------
  1275.  
  1276.      The "Configure  Node" menu  option calls  TriMan's node  configuration
  1277.      editor.
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.      TriBBS Bulletin Board System                                        20
  1284.  
  1285.  
  1286.      Edit Conferences
  1287.      ----------------
  1288.  
  1289.      The "Edit Conferences" menu option calls TriMan's message conference  
  1290.      editor.
  1291.  
  1292.      Edit Users
  1293.      ----------
  1294.  
  1295.      The "Edit Users" menu option calls TriMan's user editor.
  1296.  
  1297.      Edit Events
  1298.      -----------
  1299.  
  1300.      The "Edit Events" menu option calls TriMan's event editor.
  1301.  
  1302.      Configure System
  1303.      ----------------
  1304.  
  1305.      The "Configure System" menu option calls TriMan's system configuration
  1306.      editor.
  1307.  
  1308.      Edit File Areas
  1309.      ---------------
  1310.  
  1311.      The "Edit File Areas" menu option calls TriMan's file area editor.
  1312.  
  1313.      View Callers Log
  1314.      ----------------
  1315.  
  1316.      The "View Callers  Log" menu option  allows you to  view your  board's
  1317.      callers log.   TriBBS maintains  a log of  a user's  activity while  a
  1318.      caller is logged on.   This file is named  CALLERS.LOG and is kept  in
  1319.      node 1's MWORK directory.   By selecting the  "View Callers Log"  menu
  1320.      option, TriBBS will  prompt you for  a date to  start viewing the  log
  1321.      from.  You can simply  press <ENTER> to view  the log starting at  the
  1322.      beginning of the current day.  While you are viewing the callers  log,
  1323.      TriBBS takes the phone off the hook.  The phone will be placed back on
  1324.      the hook as soon as you return to the Waiting for Caller screen.
  1325.  
  1326.      Pack User File
  1327.      --------------
  1328.  
  1329.      The "Pack User File" menu option calls TriMan's user file packer.
  1330.  
  1331.      Exit TriBBS
  1332.      -----------
  1333.  
  1334.      The "Exit TriBBS" menu option exits you from TriBBS and returns you to
  1335.      the DOS command prompt.
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.      TriBBS Bulletin Board System                                        21
  1342.  
  1343.      Pack Message Base
  1344.      -----------------
  1345.  
  1346.      The "Pack Message Base" menu option  calls TriMan to pack the  message
  1347.      base.
  1348.  
  1349.      The Modem Status Window
  1350.      -----------------------
  1351.  
  1352.      The middle  portion of  the Waiting  for Caller  screen is  the  modem
  1353.      status window.   This window  will display  the current  state of  the
  1354.      modem: initialization information and ring detection. 
  1355.  
  1356.      The Statistics Display
  1357.      ----------------------
  1358.  
  1359.      The bottom portion of the Waiting for Caller screen displays a variety
  1360.      of information about your board: the total number of calls, the number
  1361.      of calls for the  current day, the number  of messages that have  been
  1362.      posted during the current day, the  number of uploads for the  current
  1363.      day, the number of downloads for the current day, the node number, the
  1364.      number of busy nodes, the remaining time to the next event, and more.
  1365.  
  1366.      Screen Blanking
  1367.      ---------------
  1368.  
  1369.      After five minutes  of inactivity, TriBBS  will blank  the screen  and
  1370.      bounce a "TriBBS Ready For Caller" message around the screen.  This is
  1371.      done to  prevent your  screen from  being burned  by the  Waiting  for
  1372.      Caller screen.    The Waiting  for  Caller screen  is  redisplayed  by
  1373.      pressing any key.
  1374.  
  1375.      Status Line
  1376.      -----------
  1377.  
  1378.      At the very  bottom on the  Waiting for Caller  screen, is the  status
  1379.      line.  On this line, TriBBS displays the board's registration  number,
  1380.      if it's registered, a multitasker indicator, a music note if the  page
  1381.      bell is on, and the current date and time.  Additionally, TriBBS  will
  1382.      use one  of  the following  to  indicate  if a  multitasker  has  been
  1383.      detected:
  1384.  
  1385.      +--------------------------------------------------------------------+
  1386.      |Indicator               Meaning                                     |
  1387.      +--------------------------------------------------------------------+
  1388.      |None                    No multitasker detected.                    |
  1389.      |DV                      DesqView detected.                          |
  1390.      |OS/2                    OS/2 detected.                              |
  1391.      |WIN                     Windows detected.                           |
  1392.      +--------------------------------------------------------------------+
  1393.  
  1394.      You should note that the node's page bell can be toggled on and off by
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.      TriBBS Bulletin Board System                                        22
  1401.  
  1402.      simply pressing <F3>.
  1403.  
  1404.      IMPORTANT: Because  the  Waiting  for Caller  screen  uses  TriMan  to
  1405.      perform many of its functions, you must run TriBBS with BOARD.BAT  for
  1406.      most of the Waiting for Caller screen functions to work properly.
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.      TriBBS Bulletin Board System                                        23
  1413.  
  1414.                                 DISPLAY SCREENS
  1415.                                 ---------------
  1416.  
  1417.      TriBBS allows  you to  use a  number of  optional display  screens  to
  1418.      customize your board.  These screens can be either ANSI color  screens
  1419.      or monochrome screens.  TriBBS requires you to use an extension of RIP
  1420.      for RIPscrip graphics screens, ANS for ANSI color screens and BBS  for
  1421.      monochrome screens.   All display screens  are stored  in the  DISPLAY
  1422.      subdirectory.  If you have the node configured to use its own  DISPLAY
  1423.      directory, TriBBS will look for the display screens there.  Otherwise,
  1424.      TriBBS  will  look  for  the  display  screens  in  node  1's  DISPLAY
  1425.      directory.
  1426.  
  1427.      If  the  caller   has  selected  RIPscrip   graphics  or  TriBBS   has
  1428.      autodetected it, TriBBS  will always search  the DISPLAY  subdirectory
  1429.      for RIP screens.   If a RIP screen  can't be found  or the caller  has
  1430.      selected ANSI color  graphics or TriBBS  has autodetected ANSI  color,
  1431.      TriBBS will always search the DISPLAY  subdirectory for ANS screens.  
  1432.      If TriBBS can't find an ANS screen or the caller doesn't have RIPscrip
  1433.      graphics or  ANSI  color  selected, TriBBS  will  search  the  DISPLAY
  1434.      subdirectory for an  appropriate monochrome screen.   If TriBBS  can't
  1435.      find any of  the three types  of display screens,  TriBBS will  either
  1436.      display nothing  if  it's  a simple  display  screen  or  TriBBS  will
  1437.      generate and display a menu on  the fly if an appropriate menu  screen
  1438.      isn't found.
  1439.  
  1440.      @-Variables
  1441.      -----------
  1442.  
  1443.      TriBBS supports  the  following  @-variables  in  display  screens  to
  1444.      perform a wide variety of actions:
  1445.  
  1446.      +--------------------------------------------------------------------+
  1447.      |@-variable              Action Taken                                |
  1448.      +--------------------------------------------------------------------+
  1449.      |@ALIAS@                 Displays the caller's alias.                |
  1450.      |@BAUDRATE@              Displays the caller's baud rate.            |
  1451.      |@BBSSTARTDATE@          Displays the board's starting date.         |
  1452.      |@BEEP@                  Sends a BELL (07H).                         |
  1453.      |@BIRTHDATE@             Displays the caller's birthdate.            |
  1454.      |@BOARDNAME@             Displays the board's name.                  |
  1455.      |@BREAKOFF@              Makes the screen unbreakable.               |
  1456.      |@BREAKON@               Makes the screen breakable.                 |
  1457.      |@BYTERATIO@             Displays the caller's byte ratio.           |
  1458.      |@BYTESDLTODAY@          Displays the number of bytes the caller has |
  1459.      |                        downloaded today.                           |
  1460.      |@CALLS@                 Displays the caller's number of calls.      |
  1461.      |@CALLSTODAY@            Displays the caller's number of calls for   |
  1462.      |                        today.                                      |
  1463.      |@CITY@                  Displays the caller's city.                 |
  1464.      |@CITYANDSTATE@          Displays the caller's city and state.       |
  1465.      |@CLS@                   Clears the screen.                          |
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.      TriBBS Bulletin Board System                                        24
  1472.  
  1473.      |@COUNTRY@               Displays the caller's country.              |
  1474.      |@CR@                    Displays a carriage return/line feed pair.  |
  1475.      |@DAILYBYTELIMIT@        Displays the daily byte limit for the       |
  1476.      |                        caller's security level.                    |
  1477.      |@DAILYFILELIMIT@        Displays the daily file limit for the       |
  1478.      |                        caller's security level.                    |
  1479.      |@DEFAULTCOUNTRY@        Displays the default country as defined in  |
  1480.      |                        current language file.                      |
  1481.      |@DOWNLOADS@             Displays the caller's number of downloads.  |
  1482.      |@DOWNLOADSTODAY@        Displays the number of downloads for today. |
  1483.      |@FILERATIO@             Displays the caller's file ratio.           |
  1484.      |@FILESDLTODAY@          Displays the number of files the caller has |
  1485.      |                        downloaded today.                           |
  1486.      |@FIRST@                 Displays the caller's first name.           |
  1487.      |@HANGUP@                Hangs up on the caller.                     |
  1488.      |@KDOWNLOADED@           Displays the number of K bytes the caller   |
  1489.      |                        has downloaded.                             |
  1490.      |@KUPLOADED@             Displays the number of K bytes the caller   |
  1491.      |                        has uploaded.                               |
  1492.      |@LASTDATEON@            Displays the caller's last date on.         |
  1493.      |@LASTFILECHECK@         Displays the date of the caller's last new  |
  1494.      |                        file check.                                 |
  1495.      |@LASTTIMEON@            Displays the caller's last time on.         |
  1496.      |@MESSAGES@              Displays the number of messages the caller  |
  1497.      |                        has posted.                                 |
  1498.      |@MESSAGESTODAY@         Displays the number of messages posted      |
  1499.      |                        today.                                      |
  1500.      |@MORE@                  Displays a "more" prompt.                   |
  1501.      |@MOREOFF@               Disables the "more" prompt.                 |
  1502.      |@MOREON@                Enables the "more" prompt.                  |
  1503.      |@NODE@                  Displays the node number.                   |
  1504.      |@OK@                    Pauses the display screen and waits for the |
  1505.      |                        <ENTER> key to be pressed.  You should note |
  1506.      |                        that no prompt is displayed.                |
  1507.      |@ORIGINAL@              Displays the date of the caller's original  |
  1508.      |                        log on.                                     |
  1509.      |@PAUSE@                 Prompts the caller the press a key.         |
  1510.      |@PHONE@                 Displays the caller's phone number.         |
  1511.      |@PHONESTYLE@            Displays the string "###-###-####" if the US|
  1512.      |                        phone number style is enabled.              |
  1513.      |@REGISTRATIONNUMBER@    Displays the board's registration number if |
  1514.      |                        the board is registered.  Otherwise, it will|
  1515.      |                        display "Test Drive Version!"               |
  1516.      |@SECBYTERATIO@          Displays the security level's byte ratio.   |
  1517.      |                        If the caller's security level doesn't have |
  1518.      |                        a byte ratio, TriBBS will display "No       |
  1519.      |                        Ratio!".                                    |
  1520.      |@SECFILERATIO@          Displays the security level's file ratio.   |
  1521.      |                        If the caller's security level doesn't have |
  1522.      |                        a file ratio, TriBBS will display "No       |
  1523.      |                        Ratio!".                                    |
  1524.      |@SECURITY@              Displays the caller's security level.       |
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.      TriBBS Bulletin Board System                                        25
  1531.  
  1532.      |@STATE@                 Displays the caller's state.                |
  1533.      |@STREETADDRESS1@        Displays the first line of the caller's     |
  1534.      |                        street address.                             |
  1535.      |@STREETADDRESS2@        Displays the second line of the caller's    |
  1536.      |                        street address.                             |
  1537.      |@SYSOPNAME@             Displays the sysop's name.                  |
  1538.      |@SYSTEMCALLS@           Displays the board's number of calls.       |
  1539.      |@SYSTEMCALLSTODAY@      Displays the board's number of calls for    |
  1540.      |                        today.                                      |
  1541.      |@SYSTEMDATE@            Displays the date.                          |
  1542.      |@SYSTEMTIME@            Displays the time.                          |
  1543.      |@SUBSCRIPTIONDATE@      Displays the date the caller's              |
  1544.      |                        subscription expires.                       |
  1545.      |@TIMELEFT@              Displays the number of minutes the caller   |
  1546.      |                        has left for this call.                     |
  1547.      |@TIMEON@                Displays the number of minutes the caller   |
  1548.      |                        has been on for this call.                  |
  1549.      |@TIMEREMAININGFORDAY@   Displays the amount of time the caller      |
  1550.      |                        has remaining for the day.                  |
  1551.      |@TIMETHISCALL@          Displays the total number of minutes the    |
  1552.      |                        caller has for this call.                   |
  1553.      |@TOTALCONFERENCES@      Displays the board's number of conferences. |
  1554.      |@TOTALFILEAREAS@        Displays the board's number of messages.    |
  1555.      |@TOTALMESSAGES@         Displays the board's number of messages.    |
  1556.      |@TOTALNODES@            Displays the board's number of nodes.       |
  1557.      |@TOTALUSERS@            Displays the board's number of users.       |
  1558.      |@UPLOADS@               Displays the caller's number of uploads.    |
  1559.      |@UPLOADSTODAY@          Displays the number of uploads for today.   |
  1560.      |@USER@                  Displays the caller's full name.            |
  1561.      |@VERSIONNUMBER@         Displays the TriBBS version number.         |
  1562.      |@ZIPCODE@               Displays the caller's zip code.             |
  1563.      +--------------------------------------------------------------------+
  1564.  
  1565.      You should note that case is significant for the @-variables.   TriBBS
  1566.      will simply ignore @hangup@ in a  display screen, but will hangup  the
  1567.      phone if it encounters @HANGUP@ in a display screen.
  1568.  
  1569.      @X Color Codes
  1570.      --------------
  1571.  
  1572.      TriBBS also supports @X color codes.  If the caller has ANSI  enabled,
  1573.      TriBBS will  convert the  color code  to  an appropriate  ANSI  escape
  1574.      sequence.   Otherwise, TriBBS  will filter  out the  @X color  code.  
  1575.      Therefore, it is no longer necessary to have an ANS and a BBS  version
  1576.      of a display screen.   You can simply have  a single BBS version  that
  1577.      uses @X  color codes  to add  color to  the display  screens for  ANSI
  1578.      colors.  @X color codes use the following format:
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.      TriBBS Bulletin Board System                                        26
  1585.  
  1586.      +--------------------------------------------------------------------+
  1587.      |@Xbf                                                                |
  1588.      |                                                                    |
  1589.      |Where:                                                              |
  1590.      |                                                                    |
  1591.      |b             is the background color expressed as a hexadecimal    |
  1592.      |              digit (0 to F).                                       |
  1593.      |                                                                    |
  1594.      |f             is the foreground color expressed as a hexadecimal    |
  1595.      |              digit (0 to F).                                       |
  1596.      +--------------------------------------------------------------------+
  1597.  
  1598.      The colors are represented as follows:
  1599.  
  1600.      +--------------------------------------------------------------------+
  1601.      |Background Color Code        Foreground Color Code                  |
  1602.      +--------------------------------------------------------------------+
  1603.      |0 - Black                    0 - Black                              |
  1604.      |1 - Blue                     1 - Blue                               |
  1605.      |2 - Green                    2 - Green                              |
  1606.      |3 - Cyan                     3 - Cyan                               |
  1607.      |4 - Red                      4 - Red                                |
  1608.      |5 - Magenta                  5 - Magenta                            |
  1609.      |6 - Brown                    6 - Brown                              |
  1610.      |7 - White                    7 - White                              |
  1611.      |8 - Black Blink              8 - Dark Gray                          |
  1612.      |9 - Blue Blink               9 - Light Blue                         |
  1613.      |A - Green Blink              A - Light Green                        |
  1614.      |B - Cyan Blink               B - Light Cyan                         |
  1615.      |C - Red Blink                C - Light Red                          |
  1616.      |D - Magenta Blink            D - Light Magenta                      |
  1617.      |E - Brown Blink              E - Yellow                             |
  1618.      |F - White Blink              F - Bright White                       |
  1619.      +--------------------------------------------------------------------+
  1620.  
  1621.      IMPORTANT: @-variables and @X color codes  can be used in messages  in
  1622.      local message conferences, but are ignored in networked conferences.
  1623.  
  1624.      Log On and Goodbye Screens
  1625.      --------------------------
  1626.  
  1627.      TriBBS supports up to nine log on screens and one goodbye screen.  The
  1628.      filename for a log on screen is LOGONn.RIP, LOGONn.ANS, or LOGONn.BBS.
  1629.      Where "n" is a number from 1 to 20.   After a caller answers the  ANSI
  1630.      color  graphics  prompt,  TriBBS   will  display  either   LOGON1.RIP,
  1631.      LOGON1.ANS, or LOGON1.BBS.  After the caller has entered his name  and
  1632.      password, TriBBS will display the screens  LOGON2 to LOGON19.  At  log
  1633.      off and  before TriBBS  disconnects the  caller, TriBBS  will  display
  1634.      either GOODBYE.RIP, GOODBYE.ANS, or GOODBYE.BBS.
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.      TriBBS Bulletin Board System                                        27
  1641.  
  1642.      Security Specific Log On Screens
  1643.      --------------------------------
  1644.  
  1645.      TriBBS supports security specific log on screens.  The filename for  a
  1646.      security specific  log  on screen  is  either nSEC.RIP,  nSEC.ANS,  or
  1647.      nSEC.BBS.  Where "n"  is the security  level for the  log on screen.  
  1648.      Security specific log on screens  are displayed after TriBBS  displays
  1649.      the normal log on screens.
  1650.  
  1651.      Newsletter Log On Screen
  1652.      ------------------------
  1653.  
  1654.      TriBBS supports  a newsletter  log  on screen.    The filename  for  a
  1655.      newsletter log  on  screen  is  either  BBSNEWS.RIP,  BBSNEWS.ANS,  or
  1656.      BBSNEWS.BBS.  A newsletter  log on screen is  displayed to the  caller
  1657.      after TriBBS  displays  any  security specific  log  on  screens.    A
  1658.      newsletter log on  screen is  only displayed  if it  has been  updated
  1659.      since the user's last call.
  1660.  
  1661.      User Specific Log On Screens
  1662.      ----------------------------
  1663.  
  1664.      TriBBS supports user specific log on screens.  The filename for a user
  1665.      specific log on screen is either n.RIP, n.ANS, or n.BBS.  Where "n" is
  1666.      the caller's user number.  User specific log on screens are  displayed
  1667.      after TriBBS  displays any  newsletter log  on screen.   Once  a  user
  1668.      specific log on screen has been  displayed to the appropriate  caller,
  1669.      TriBBS automatically deletes  the screen.   User specific screens  are
  1670.      unique in the  fact that they  are always stored  in node 1's  DISPLAY
  1671.      directory.
  1672.  
  1673.      New User Screen
  1674.      ---------------
  1675.  
  1676.      After a new user enters his name and indicates that he is a new  user,
  1677.      TriBBS  will  display   a  special  new   user  screen  named   either
  1678.      NEWUSER.RIP, NEWUSER.ANS, or NEWUSER.BBS.
  1679.  
  1680.      Bulletin Menu and Bulletins
  1681.      ---------------------------
  1682.  
  1683.      Normally, TriBBS will generate  a Bulletin Menu  on the fly;  however,
  1684.      you may  use  a custom  Bulletin  Menu  by naming  the  display  files
  1685.      BULLETIN.RIP, BULLETIN.ANS, and BULLETIN.BBS.
  1686.  
  1687.      You can have  from 1 to  99 bulletins by  naming them as  BULLETn.RIP,
  1688.      BULLETn.ANS, and BULLETn.BBS.  Where "n" is a number from 1 to 99.
  1689.  
  1690.      Main Menu
  1691.      ---------
  1692.  
  1693.      Normally, TriBBS will generate a Main  Menu for the caller's  security
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.      TriBBS Bulletin Board System                                        28
  1700.  
  1701.      level on the fly; however, you may use custom Main Menus by naming the
  1702.      display files MAINn.RIP, MAINn.ANS, and MAINn.BBS.   Where "n" is  the
  1703.      menu's security level.   You may  also have custom  Main Menu  display
  1704.      screens called  MAINALL.RIP,  MAINALL.ANS,  and  MAINALL.BBS.    These
  1705.      custom screens will be displayed if none of your MAINn.RIP, MAINn.ANS,
  1706.      or MAINn.BBS screens match the caller's security level.
  1707.  
  1708.      Message Menu
  1709.      ------------
  1710.  
  1711.      Normally, TriBBS  will  generate  a  Message  Menu  for  the  caller's
  1712.      security level on the fly; however,  you may use custom Message  Menus
  1713.      by naming  the display  files MESSn.RIP,  MESSn.ANS, and  MESSn.BBS.  
  1714.      Where "n" is  the menu's  security level.   You may  also have  custom
  1715.      Message Menu  display  screens called  MESSALL.RIP,  MESSALL.ANS,  and
  1716.      MESSALL.BBS.  These custom screens will  be displayed if none of  your
  1717.      MESSn.RIP, MESSn.ANS, or MESSn.BBS screens match the caller's security
  1718.      level.
  1719.  
  1720.      File Menu
  1721.      ---------
  1722.  
  1723.      Normally, TriBBS will generate a File  Menu for the caller's  security
  1724.      level on the fly; however, you may use custom File Menus by naming the
  1725.      display files FILEn.RIP, FILEn.ANS, and FILEn.BBS.   Where "n" is  the
  1726.      menu's security level.   You may  also have custom  File Menu  display
  1727.      screens called  FILEALL.RIP,  FILEALL.ANS,  and  FILEALL.BBS.    These
  1728.      custom screens will be displayed if none of your FILEn.RIP, FILEn.ANS,
  1729.      or FILEn.BBS screens match the caller's security level.
  1730.  
  1731.      Upload Screens
  1732.      --------------
  1733.  
  1734.      TriBBS supports  an  optional upload  display  screen.   This  display
  1735.      screen, if present,  is displayed after  the caller  selects the  File
  1736.      Menu's Upload option.  The file names for the optional upload  screens
  1737.      are UPn.RIP, UPn.ANS, and UPn.BBS.  Where "n" is the display  screen's
  1738.      security level.  You may also have custom upload display screens named
  1739.      UPALL.RIP, UPALL.ANS, and  UPALL.BBS.   These custom  screens will  be
  1740.      displayed if none of your UPn.RIP,  UPn.ANS, or UPn.BBS screens  match
  1741.      the caller's security level.
  1742.  
  1743.      Download Screens
  1744.      ----------------
  1745.  
  1746.      TriBBS supports an  optional download  display screen.   This  display
  1747.      screen, if present,  is displayed after  the caller  selects the  File
  1748.      Menu's Download  option.   The file  names for  the optional  download
  1749.      screens are DOWNn.RIP,  DOWNn.ANS, and DOWNn.BBS.   Where  "n" is  the
  1750.      display screen's security level.   You may  also have custom  download
  1751.      display screens  named  DOWNALL.RIP, DOWNALL.ANS,  and  DOWNALL.BBS.  
  1752.      These custom  screens will  be displayed  if none  of your  DOWNn.RIP,
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.      TriBBS Bulletin Board System                                        29
  1759.  
  1760.      DOWNn.ANS, or DOWNn.BBS screens match the caller's security level.
  1761.  
  1762.      Door Menu
  1763.      ---------
  1764.  
  1765.      Normally, TriBBS will generate a Door  Menu for the caller's  security
  1766.      level on the fly; however, you may use custom Door Menus by naming the
  1767.      display files DOORn.RIP, DOORn.ANS, and DOORn.BBS.   Where "n" is  the
  1768.      menu's security level.  You may  also have a custom Door Menu  display
  1769.      screens called DOORALL.RIP, DOORALL.ANS, and DOORALL.BBS. These custom
  1770.      screens will be  displayed if none  of your  DOORn.RIP, DOORn.ANS,  or
  1771.      DOORn.BBS screens match the caller's security level.
  1772.  
  1773.      Door Bulletin Menu and Door Bulletins
  1774.      -------------------------------------
  1775.  
  1776.      Normally, TriBBS  will  generate a  Door  Bulletin Menu  on  the  fly;
  1777.      however, you may use a custom Door Bulletin Menu by naming the display
  1778.      files DOORBULL.RIP, DOORBULL.ANS and DOORBULL.BBS.
  1779.  
  1780.      You  can  have  from  1  to  99  door  bulletins  by  naming  them  as
  1781.      DRBULLn.RIP, DRBULLn.ANS and DRBULLn.BBS.  Where "n" is a number  from
  1782.      1 to 99.
  1783.  
  1784.      Questionnaire Menu
  1785.      -----------------
  1786.  
  1787.      Normally, TriBBS will generate a  Questionnaire Menu for the  caller's
  1788.      security level on the fly; however, you may use a custom Questionnaire
  1789.      Menu  by  naming  the   display  files  QUESTn.RIP,  QUESTn.ANS,   and
  1790.      QUESTn.BBS.  Where  "n" is the  menu's security level.   You may  also
  1791.      have custom Questionnaire  Menu display  screens called  QUESTALL.RIP,
  1792.      QUESTALL.ANS, or QUESTALL.BBS.  These custom screens will be displayed
  1793.      if none of  your QUESTn.RIP, QUESTn.ANS,  or QUESTn.BBS screens  match
  1794.      the caller's security level.
  1795.  
  1796.      Sysop Menu
  1797.      ----------
  1798.  
  1799.      Normally, TriBBS will generate a Sysop Menu for the caller's  security
  1800.      level on the fly;  however, you may use  custom Sysop Menus by  naming
  1801.      the display files SYSOPn.RIP, SYSOPn.ANS,  and SYSOPn.BBS.  Where  "n"
  1802.      is the menu's  security level.   You may also  have custom Sysop  Menu
  1803.      display screens called SYSOPALL.RIP, SYSOPALL.ANS, and SYSOPALL.BBS.  
  1804.      These custom screens  will be displayed  if none  of your  SYSOPn.RIP,
  1805.      SYSOPn.ANS, or SYSOPn.BBS screens match the caller's security level.
  1806.  
  1807.      List of Conferences
  1808.      -------------------
  1809.  
  1810.      When changing conferences and  the caller selects  to choose from  all
  1811.      conferences, TriBBS supports  an optional custom  list of  conferences
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.      TriBBS Bulletin Board System                                        30
  1818.  
  1819.      that will be displayed whenever a  caller wants to change the  message
  1820.      conference he  is  in.   The  file  names for  the  custom  conference
  1821.      listings are  MSGn.RIP, MSGn.ANS,  and MSGn.BBS.    Where "n"  is  the
  1822.      display screen's security level.  You  may also have a custom list  of
  1823.      conference names called MSGALL.RIP, MSGALL.ANS, and MSGALL.BBS.  These
  1824.      custom screens will be displayed if  none of your MSGn.RIP,  MSGn.ANS,
  1825.      or MSGn.BBS display screens match the caller's security level.
  1826.  
  1827.      When changing  conferences  and  the  caller  selects  to  choose  the
  1828.      conference by network, TriBBS  will optionally display a  NETWORK.RIP,
  1829.      NETWORK.ANS,     and     NETWORK.BBS     screens.          If      the
  1830.      NETWORK.RIP/NETWORK.ANS/NETWORK.BBS screens  aren't available,  TriBBS
  1831.      will display a list of available  networks.  After the caller  selects
  1832.      the appropriate network,  TriBBS will optionally  display a  NETn.RIP,
  1833.      NETn.ANS,  and  NETn.BBS  (where  "n"  is  1  for  the  board's  local
  1834.      conferences, 2 is the first network's conferences, etc.) to display  a
  1835.      list  of  the  available   conferences  in  the   network.    If   the
  1836.      NETn.RIP/NETn.ANS/NETn.BBS  screens  aren't  available,  TriBBS   will
  1837.      display a  list of  the conferences  that  available in  the  selected
  1838.      network.
  1839.  
  1840.      List of File Areas
  1841.      ------------------
  1842.  
  1843.      TriBBS supports an  optional custom list  of file areas  that will  be
  1844.      displayed whenever a caller wants to change  the file area he is in.  
  1845.      The file  names  for the  custom  file area  listings  are  DIRSn.RIP,
  1846.      DIRSn.ANS, and DIRSn.BBS.  Where "n" is the display screen's  security
  1847.      level.   You  may  also  have  a custom  list  of  file  areas  called
  1848.      DIRSALL.RIP, DIRSALL.ANS, and DIRSALL.BBS   These custom screens  will
  1849.      be displayed  if  none  of your  DIRSn.RIP,  DIRSn.ANS,  or  DIRSn.BBS
  1850.      display screens match the caller's security level.
  1851.  
  1852.      Chat Screens
  1853.      ------------
  1854.  
  1855.      TriBBS  supports  four  optional   chat  related  display  screens:   
  1856.      SORRY.RIP/SORRY.ANS/SORRY.BBS will  be displayed  if the  sysop  isn't
  1857.      available for  chat,  USERCHAT.RIP/USERCHAT.ANS/USERCHAT.BBS  will  be
  1858.      displayed  if  the   chat  is   initiated  at   the  user's   request,
  1859.      SYSCHAT.RIP/SYSCHAT.ANS/SYSCHAT.BBS will be displayed  if the chat  is
  1860.      initiated by  the  sysop,  and  NOTTHERE.RIP/NOTTHERE.ANS/NOTTHERE.BBS
  1861.      will be displayed if the caller requests a chat and the sysop  doesn't
  1862.      answer.
  1863.  
  1864.      Log On Related Screens
  1865.      ----------------------
  1866.  
  1867.      TriBBS  supports  ten  optional   log  on  related  display   screens:
  1868.      LOCKOUT.RIP/LOCKOUT.ANS/LOCKOUT.BBS will  be displayed  if the  caller
  1869.      has  been  locked  out,  DELETED.RIP/DELETED.ANS/DELETED.BBS  will  be
  1870.      displayed if the caller's  user record has  been marked for  deletion,
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.      TriBBS Bulletin Board System                                        31
  1877.  
  1878.      TOOLOW.RIP/TOOLOW.ANS/TOOLOW.BBS will  be  displayed if  the  caller's
  1879.      security level is too low for the node,  NONEW.RIP/NONEW.ANS/NONEW.BBS
  1880.      will be displayed if  the new user's security  level is less than  the
  1881.      node's security  level,  TOOMANY.RIP/TOOMANY.ANS/TOOMANY.BBS  will  be
  1882.      displayed if  the  caller has  exceeded  his number  of  daily  calls,
  1883.      PENDING.RIP/PENDING.ANS/PENDING.BBS will be displayed if the  caller's
  1884.      time    has    been    adjusted    due    to    a    pending    event,
  1885.      FRONTEND.RIP/FRONTEND.ANS/FRONTEND.BBS  will  be   displayed  if   the
  1886.      caller's  time  has   been  adjusted  due   to  a  frontend   program,
  1887.      PASSWORD.RIP/PASSWORD.ANS/PASSWORD.BBS will  be  displayed for  a  new
  1888.      user    just    before    his     password    is    requested,     and
  1889.      ALIAS.RIP/ALIAS.ANS/ALIAS.BBS will be  displayed for a  new user  just
  1890.      before his alias is requested.
  1891.  
  1892.      Comment Screen
  1893.      --------------
  1894.  
  1895.      Whenever a caller  chooses to leave  a comment for  the sysop,  TriBBS
  1896.      will display an  optional COMMENT.RIP/COMMENT.ANS/COMMENT.BBS  display
  1897.      screen.
  1898.  
  1899.      <F8> Logoff Screen
  1900.      ------------------
  1901.  
  1902.      Whenever the sysop presses  the <F8> key,  TriBBS will display  either
  1903.      NUKE.RIP, NUKE.ANS, or NUKE.BBS and log the caller off the system.
  1904.  
  1905.      Full-Screen Editor Help Screen
  1906.      ------------------------------
  1907.  
  1908.      Whenever the  caller selects  the  full-screen editor's  help  screen,
  1909.      TriBBS will display either FSCREEN.RIP, FSCREEN.ANS, or FSCREEN.BBS.  
  1910.      You should note that a FSCREEN.BBS  display screen is supplied in  the
  1911.      TriBBS archive,  but you  can of  course create  your own  full-screen
  1912.      editor help screens.
  1913.  
  1914.      TeleChat Help Screen
  1915.      --------------------
  1916.  
  1917.      Whenever the caller selects the TeleChat menu's help function,  TriBBS
  1918.      will display either  TCHAT.RIP, TCHAT.ANS, or  TCHAT.BBS.  You  should
  1919.      note that  a  TCHAT.BBS  display screen  is  supplied  in  the  TriBBS
  1920.      archive, but you can of course create your own TeleChat help screens.
  1921.  
  1922.      File/Byte Ratio Screens
  1923.      -----------------------
  1924.  
  1925.      Whenever the  caller's security  level has  been lowered  by  TriBBS's
  1926.      optional file/byte ratio  checking, TriBBS will  display the  optional
  1927.      screens   LOWER.RIP,    LOWER.ANS,   and    LOWER.BBS.       If    the
  1928.      LOWER.RIP/LOWER.ANS/LOWER.BBS screens  aren't  available  TriBBS  will
  1929.      display an appropriate message.
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.      TriBBS Bulletin Board System                                        32
  1936.  
  1937.  
  1938.      Whenever the  caller's  security level  has  been raised  by  TriBBS's
  1939.      optional file/byte ratio  checking, TriBBS will  display the  optional
  1940.      screens   RAISE.RIP,    RAISE.ANS,   and    RAISE.BBS.       If    the
  1941.      RAISE.RIP/RAISE.ANS/RAISE.BBS screens  aren't  available  TriBBS  will
  1942.      display an appropriate message.
  1943.  
  1944.      Whenever the  caller's  file/byte  ratio  no  longer  permits  him  to
  1945.      download files, TriBBS will  display the optional screens  NODOWN.RIP,
  1946.      NODOWN.ANS, and NODOWN.BBS.  If the  NOWDOWN.RIP/NODOWN.ANS/NODOWN.BBS
  1947.      screens aren't available TriBBS will display an appropriate message.
  1948.  
  1949.      Subscription Screens
  1950.      --------------------
  1951.  
  1952.      Whenever the caller's  subscription has expired,  TriBBS will  display
  1953.      the optional screens  EXPIRED.RIP, EXPIRED.ANS, and  EXPIRED.BBS.   If
  1954.      the  EXPIRED.RIP/EXPIRED.ANS/EXPIRED.BBS  screens  aren't   available,
  1955.      TriBBS will display an appropriate message.
  1956.  
  1957.      Unwanted Files Screen
  1958.      ---------------------
  1959.  
  1960.      Whenever a caller attempts to upload  a file that matches an  unwanted
  1961.      file name in  DONTWANT.DAT, TriBBS will  display the optional  screens
  1962.      DONTWANT.RIP,   DONTWANT.ANS,    and    DONTWANT.BBS.        If    the
  1963.      DONTWANT.RIP/DONTWANT.ANS/DONTWANT.BBS   screens   aren't   available,
  1964.      TriBBS will display an appropriate message.
  1965.  
  1966.      Language Menu Screen
  1967.      --------------------
  1968.  
  1969.      Whenever a caller selects the main menu's <L> Change Language  option,
  1970.      TriBBS will display the  optional screens LANGUAGE.RIP,  LANGUAGE.ANS,
  1971.      and  LANGUAGE.BBS.    If  the   LANGUAGE.RIP/LANGUAGE.ANS/LANGUAGE.BBS
  1972.      screens aren't available, TriBBS will display an appropriate messages.
  1973.  
  1974.      External Chat Screens
  1975.      ---------------------
  1976.  
  1977.      Whenever  TriBBS  runs  an  external  chat  program  via  CHAT.BAT  or
  1978.      PAGE.BAT,  it   will  display   the  optional   screens   EXTCHAT.RIP,
  1979.      EXTCHAT.ANS, or EXTCHAT.BBS, if  CHAT.BAT was called, or  EXTPAGE.RIP,
  1980.      EXTPAGE.ANS, and EXTPAGE.BBS, if PAGE.BAT was called.
  1981.  
  1982.      RIPscrip Borders For ANSI and ASCII Screens
  1983.      -------------------------------------------
  1984.  
  1985.      Whenever the caller  has RIPscrip  graphics enabled  and TriBBS  can't
  1986.      find a RIP version of a display screen, it will look for a file called
  1987.      POSTRIP.RIP.  If a  POSTRIP.RIP screen is  found, TriBBS will  display
  1988.      its contents before displaying the  appropriate ANSI or ASCII  version
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.      TriBBS Bulletin Board System                                        33
  1995.  
  1996.      of the  display screen.   POSTRIP.RIP  is mainly  used for  drawing  a
  1997.      border around a text window for ANSI and ASCII display screens.   This
  1998.      can really add the finishing touch to a board that offers RIP  screens
  1999.      and menus, but  doesn't want  to have  RIP versions  of every  display
  2000.      screen.
  2001.  
  2002.      Making Your Own Display Screens
  2003.      -------------------------------
  2004.  
  2005.      To make  your own  custom display  screens, you'll  need a  good  ANSI
  2006.      screen editor.  Perhaps one of the best is a shareware product  called
  2007.      TheDraw (available for download on Freejack's Place).
  2008.  
  2009.      The best  programs  for creating  RIPscrip  graphics are  RIPaint  and
  2010.      RIPDraw.  Both are  commercial programs and  can be purchased  through
  2011.      TeleGrafix Communications, Inc., the creators of RIPscrip graphics. 
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.      TriBBS Bulletin Board System                                        34
  2018.  
  2019.                                SETTING UP A DOOR
  2020.                                -----------------
  2021.  
  2022.      This section of the manual explains how a door is setup.  It will take
  2023.      you step-by-step through  the process of  setting up  a rather  simple
  2024.      door called TestDoor.  TestDoor picks a number from 1 to 100 and  asks
  2025.      the caller to guess what the secret number is.
  2026.  
  2027.      Enabling The Door Menu
  2028.      ----------------------
  2029.  
  2030.      The first step in setting up your board to run doors is to enable  the
  2031.      main menu's Door Menu option.  By default, this menu option is set  to
  2032.      a security level of 999.  Because  this security level is so high,  it
  2033.      effectively disables the door menu.
  2034.  
  2035.      To enable  the  door menu,  you  must first  be  in your  main  TriBBS
  2036.      directory.  For  the rest of  this section, we  will assume that  your
  2037.      main TriBBS  directory is  C:\TRIBBS.   To change  to this  directory,
  2038.      enter the following at the DOS prompt:
  2039.  
  2040.      CD \TRIBBS
  2041.  
  2042.      Now run TriMan,  by entering  the following  command line  at the  DOS
  2043.      prompt:
  2044.  
  2045.      TRIMAN
  2046.  
  2047.      Next pull down the Menus menu,  by pressing <ALT><M>.  Press <M>  from
  2048.      the  Menus  menu  to  select  the   Main  Menu  option.    Press   the
  2049.      <DOWN><ARROW> multiple times, until you are located in the main menu's
  2050.      Door Menu option's line.  Press the <TAB> key multiple times until the
  2051.      Security Level field is highlighted. Enter "10" to change the security
  2052.      level to 10.  Press <F10> to save the new main menu.
  2053.  
  2054.      Now we need to edit the  door menu.  Once  again, pull down the  Menus
  2055.      menu, by pressing <ALT><M>.  Press  <D> from the Menus menu to  select
  2056.      the Door Menu option.   Press <F2> to  add a line to  the door menu.  
  2057.      Because TestDoor will be using TRIBBS.SYS, we can leave the Door  Type
  2058.      field set to "T".   Press <TAB> to move  the highlighting to the  Door
  2059.      Description field.  In this field enter, "TestDoor".  Press <TAB> once
  2060.      more to move  the highlighting to  the Door Batch  File field.   Enter
  2061.      TESTDOOR, for the name of the door's batch file.  Finally, press <TAB>
  2062.      to move to the  Security Level field  and enter 10  to set the  door's
  2063.      security level to 10,  save the new door  menu by pressing <F10>,  and
  2064.      press <ALT><E> to exit from TriMan.
  2065.  
  2066.      Believe it or not, you  have now configured TriBBS  to run the door.  
  2067.      However, we haven't setup the door yet.
  2068.  
  2069.      Setting Up TestDoor
  2070.      -------------------
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.      TriBBS Bulletin Board System                                        35
  2077.  
  2078.  
  2079.      We must first create a subdirectory for  the door to reside in.   Most
  2080.      people setup a DOORS subdirectory off  of their main TriBBS  directory
  2081.      and then setup  another subdirectory off  of the  DOORS directory  for
  2082.      each individual  door.   This  can  be accomplished  by  entering  the
  2083.      following two commands at the DOS prompt:
  2084.  
  2085.      MD \TRIBBS\DOORS
  2086.      MD \TRIBBS\DOORS\TESTDOOR
  2087.  
  2088.      Next we  must  copy  the file  TESTDOOR.EXE  into  the  newly  created
  2089.      directory with the following DOS command:
  2090.  
  2091.      COPY TESTDOOR.EXE \TRIBBS\DOORS\TESTDOOR
  2092.  
  2093.      We now have  to create  a configuration  file that  TestDoor needs  in
  2094.      order to run properly.  We must first change to the TestDoor directory
  2095.      with the following DOS command:
  2096.  
  2097.      CD \TRIBBS\DOORS\TESTDOOR
  2098.  
  2099.      Now we can create  the configuration file with  a text editor such  as
  2100.      DOS's  EDIT  editor.    The   configuration  files  should  be   named
  2101.      TESTDOOR.CFG and should look similar to the following:
  2102.  
  2103.      TRIBBS
  2104.      C:\TRIBBS
  2105.      Freejack's Place
  2106.      Gary Price
  2107.      38400
  2108.  
  2109.      The following explains  what each line  in the TestDoor  configuration
  2110.      file does:
  2111.  
  2112.      TRIBBS                   <- This tells TestDoor to use TRIBBS.SYS
  2113.      C:\TRIBBS                <- This  tells TestDoor  where TRIBBS.SYS  is
  2114.                               located.   Remember  when we  configured  the
  2115.                               door menu line for TestDoor, we configured it
  2116.                               so that  TriBBS  will create  the  TRIBBS.SYS
  2117.                               drop file for the door.  When TriBBS  creates
  2118.                               a door drop  file, it will  always place  the
  2119.                               drop file in the node's main directory.
  2120.      Freejack's Place         <- This tells TestDoor that the BBS's name is
  2121.                                "Freejack's Place".   Obviously,  you  will
  2122.                               want to change this line to reflect the  name
  2123.                               of your board.
  2124.      Gary Price               <- This tells TestDoor that the sysop's  name
  2125.                               is "Gary Price".   Once  again, you will want
  2126.                               to change this line to hold your name.
  2127.      38400                    <- This  tells TestDoor  to lock  the  serial
  2128.                               port at  38400.    If you  are  locking  your
  2129.                               serial port at a  different baud rate,  enter
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.      TriBBS Bulletin Board System                                        36
  2136.  
  2137.                               the appropriate value in  this line.  If  you
  2138.                               are not locking your  baud rate, you need  to
  2139.                               enter 0 in  this line so  that TestDoor  will
  2140.                               not attempt to maintain a locked serial port.
  2141.  
  2142.      Only one more step to go and  TestDoor will be fully functional.   The
  2143.      last step in the process is to create the batch file that TriBBS  will
  2144.      use to run the door.   To keep the board  well organized, we will  put
  2145.      this in the node's  BATCH subdirectory.  You  can change to the  BATCH
  2146.      subdirectory, but entering the following DOS command:
  2147.  
  2148.      CD \TRIBBS\BATCH
  2149.  
  2150.      With  your  text  editor,  create  the  following  batch  file  called
  2151.      TESTDOOR.BAT (Remember, that's  the name for  the batch  file name  we
  2152.      specified in the door menu configuration line for TestDoor):
  2153.  
  2154.      CD \TRIBBS\DOORS\TESTDOOR
  2155.      TESTDOOR TESTDOOR.CFG
  2156.      CD \TRIBBS
  2157.      BOARD.BAT
  2158.  
  2159.      Here's an explanation of each line in the door's batch file:
  2160.  
  2161.      CD \TRIBBS\DOORS\TESTDOOR     <-  This  line  simply  changes  to  the
  2162.                                    door's directory.
  2163.      TESTDOOR TESTDOOR.CFG         <- This line runs the door.
  2164.      CD \TRIBBS                    <- This line changes back to the  node's
  2165.                                    main directory.
  2166.      BOARD.BAT                     <-  This  line  runs  TriBBS  again,  by
  2167.                                    running BOARD.BAT.
  2168.  
  2169.      There you have it.  TestDoor  should now be fully functional.   Simply
  2170.      log onto your BBS, select <D>  at the main menu, select TestDoor  from
  2171.      the doors menu,  and have  fun.   If TestDoor  doesn't work  properly,
  2172.      you've probably made a typo or some other simple error along the  way.
  2173.      Simply review each  step in  the setup  procedure to  insure that  you
  2174.      performed each step correctly.
  2175.  
  2176.      Advice About Doors
  2177.      ------------------
  2178.  
  2179.      TestDoor is about  the simplest door  to setup that  you'll ever  come
  2180.      across.  Some doors will have a much more complex setup  requirements.
  2181.      The key to setting  up any door  is to read  and fully understand  the
  2182.      documentation that comes with each door.  The main differences  you'll
  2183.      encounter are as follows:
  2184.  
  2185.           1) Not all  doors will  allow you to  use TRIBBS.SYS  for a  drop
  2186.           file.  Most doors  use DOOR.SYS, which is  a pretty generic  door
  2187.           drop file and is widely supported by most BBS software.  Be  sure
  2188.           that you specify the correct door  drop file type in TriMan  when
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.      TriBBS Bulletin Board System                                        37
  2195.  
  2196.           adding the door to your door menu configuration.
  2197.  
  2198.           2) Each door should  have a uniquely named  door batch file.   Do
  2199.           not name  your  door batch  file  DOOR.BAT, because  that's  used
  2200.           internally by TriBBS to run all doors.
  2201.  
  2202.           3) Pay  particular attention  to each  door's configuration  file
  2203.           requirements.  The  door's configuration  requirements should  be
  2204.           fully explained in the door's documentation file.
  2205.  
  2206.           4) Determine from the door's docs  what command line you'll  need
  2207.           to use in the door's batch file  to actually run the door.   This
  2208.           varies from one door to the next so read the docs. 
  2209.  
  2210.      Support For Doors
  2211.      -----------------
  2212.  
  2213.      Freejack's Software will provide full support for how doors are  setup
  2214.      with TriBBS in  general.  However,  it is  not our  responsibility  to
  2215.      support each and every door  that  is on  the  market.  Basically,  if
  2216.      you  can  setup  TestDoor  without any problems,  then  you should not
  2217.      contact Freejack's Software  for  support  if  you  run  into problems
  2218.      setting  up another door.  It is  the  door author's responsibility to
  2219.      provide  you with support for  setting  up his doors.  Do not fall for
  2220.      excuses like: "It must  be the BBS software's fault so contact the BBS
  2221.      software author." Although many door authors provide excellent support
  2222.      for their software, there  are many less reputable authors who like to
  2223.      pawn off support problems onto the BBS software author.
  2224.  
  2225.      In all  fairness to  the door  author, please  read the  documentation
  2226.      fully before attempting to  setup a door.   If you run into  problems,
  2227.      reread the docs.   If you  still are experiencing  problems, then  and
  2228.      only then contact the  door author for  support.  It  is not the  door
  2229.      author's purpose in life to spoon feed sysops who are too lazy to read
  2230.      the documentation that comes with their programs.
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.      TriBBS Bulletin Board System                                        38
  2237.  
  2238.                                 EXTENDED MENU COMMANDS
  2239.                              ----------------------
  2240.  
  2241.      TriBBS allows the sysop  to easily extend the  Main Menu, the  Message
  2242.      Menu, the File Menu, and the Sysop  Menu through the use of doors  and
  2243.      batch files.  The  first step in extending  a menu is  to add the  new
  2244.      command's hotkey  character, description,  and security  level to  the
  2245.      desired menu.  For example, let's suppose you wanted to add TriMail to
  2246.      your Message  Menu.   The  following is  a  sample Message  Menu  with
  2247.      TriMail added to it:
  2248.  
  2249.      +--------------------------------------------------------------------+
  2250.      |C,C,Change Conference,10                                            |
  2251.      |E,E,Enter a Message,10                                              |
  2252.      |R,R,Read Messages,10                                                |
  2253.      |N,N,New Messages,10                                                 |
  2254.      |Y,Y,Your Messages,10                                                |
  2255.      |S,S,Text Search Messages,10                                         |
  2256.      |Q,Q,Set Conference Queue,10                                         |
  2257.      |T,T,TriMail,10                                                      |
  2258.      |M,M,Main Menu,0                                                     |
  2259.      |X,X,Expert Mode,10                                                  |
  2260.      |P,P,Page Sysop,0                                                    |
  2261.      |G,G,Goodbye,0                                                       |
  2262.      +--------------------------------------------------------------------+
  2263.  
  2264.      As the above sample  Message Menu shows,  the new command's  hardcoded
  2265.      and configurable hotkeys  are "T", its  description is "TriMail",  and
  2266.      its security  level is  "10".   You  should note  that a  custom  menu
  2267.      option's hardcoded hotkey can be any  key expect one of the  hardcoded
  2268.      hotkeys that TriBBS uses  internally for the  menu.  The  configurable
  2269.      hotkey can be any key that isn't being used by another command.
  2270.  
  2271.      The next step to get the custom menu command functioning is to  create
  2272.      a batch file  that TriBBS will  call to carry  out the  command.   The
  2273.      filename must be MAINh.BAT (where "h"  is the hardcoded hotkey) for  a
  2274.      custom Main  Menu  command,  MESSh.BAT (where  "h"  is  the  hardcoded
  2275.      hotkey) for a custom Message Menu command, FILEh.BAT (where "h" is the
  2276.      hardcoded hotkey) for a custom File  Menu command, or SYSh.BAT  (where
  2277.      "h" is the hardcoded hotkey) for a custom Sysop Menu command.  So  for
  2278.      our example TriMail Message Menu command,  the proper batch file  name
  2279.      would be MESST.BAT and could be a batch file similar to the following:
  2280.  
  2281.      cd \doors\trimail
  2282.      trimail tmail1.cfg
  2283.      cd \tribbs
  2284.      board
  2285.  
  2286.      At this  point,  you may  be  wondering  where TriMail  will  get  the
  2287.      necessary door  data files  it  needs to  run.   Before  exiting  from
  2288.      memory, TriBBS generates all of its possible door data files and  then
  2289.      simply runs the proper batch file just like it would a door.  However,
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.      TriBBS Bulletin Board System                                        39
  2296.  
  2297.      you  should note that it isn't strictly  necessary to run a door as  a
  2298.      custom menu command.  You  can make a command  out of pretty much  any
  2299.      program.  The only limits are your imagination.
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.      TriBBS Bulletin Board System                                        40
  2306.  
  2307.                             CREATING A QUESTIONNAIRE
  2308.                             ------------------------
  2309.  
  2310.      TriBBS allows you to setup a  questionnaire menu via TriMan to  survey
  2311.      your callers.  Your questionnaire files must have an extension of .QUE
  2312.      and must reside  in node 1's  MWORK directory.   The responses to  the
  2313.      questionnaires will be stored  in node 1's  MWORK directory using  the
  2314.      file name specified for the questionnaire  in TriMan and will have  an
  2315.      extension of .ANS.
  2316.  
  2317.      The questionnaire file is a simple text file that you can create  with
  2318.      any text editor.  Be sure to name  the file with the name you  specify
  2319.      in the questionnaire configuration and use an extension of .QUE.  Each
  2320.      line in the  questionnaire file  will be  displayed as  is unless  the
  2321.      lines starts with one of the following characters:
  2322.  
  2323.      :                   Will display  the line  and  prompt the  user  for
  2324.                          input.  Note that the caller must enter  something
  2325.                          in response to this prompt.
  2326.  
  2327.      ;                   Will display  the line  and  prompt the  user  for
  2328.                          input.  Note  that the  caller can  enter a  blank
  2329.                          line in response to this prompt.
  2330.  
  2331.      @                   Will display the line and prompt the user to enter
  2332.                          a date  using  the  format MM-DD-YY.    After  the
  2333.                          caller has entered  the date,  TriBBS will  prompt
  2334.                          the caller to see if it was entered correctly.
  2335.  
  2336.      #                   Will display the line and prompt the user to enter
  2337.                          the phone number using  the format ###-###-####.  
  2338.                          After the  caller has  entered the  phone  number,
  2339.                          TriBBS will prompt  the caller  to see  if it  was
  2340.                          entered correctly.
  2341.  
  2342.      ^security level     Will set the caller's security level to the number
  2343.                          specified after "^".
  2344.  
  2345.      ?                   Will prompt the  user for a  Yes/No response.   If
  2346.                          the caller  responds  with a  "Yes",  TriBBS  will
  2347.                          ignore the  remaining questionnaire  until  TriBBS
  2348.                          finds a "+" character.  TriBBS will continue  with
  2349.                          the questionnaire until  another "+" character  is
  2350.                          encountered.  If the caller responds with a  "No",
  2351.                          TriBBS will  ignore  the  remaining  questionnaire
  2352.                          until TriBBS finds a  "-" character.  TriBBS  will
  2353.                          continue with the questionnaire until another  "-"
  2354.                          character is encountered.  Yes/No questions can be
  2355.                          nested to ten levels deep.
  2356.  
  2357.                          NOTE: If the first three nonspace characters in  a
  2358.                          line are REM or rem, TriBBS will treat the line as
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.      TriBBS Bulletin Board System                                        41
  2365.  
  2366.                          a comment and will not display it.
  2367.  
  2368.      The following is a sample questionnaire file:
  2369.  
  2370.      +--------------------------------------------------------------------+
  2371.      |Please answer the following questions truthfully:                   |
  2372.      |                                                                    |
  2373.      |:What is your real name?                                            |
  2374.      |                                                                    |
  2375.      |:What is your street address?                                       |
  2376.      |                                                                    |
  2377.      |:What is your city, state, and zip code?                            |
  2378.      |                                                                    |
  2379.      |:What type of computer do you own?                                  |
  2380.      |                                                                    |
  2381.      |:What type of modem are you using?                                  |
  2382.      |                                                                    |
  2383.      |:What type of communications software are you using?                |
  2384.      |                                                                    |
  2385.      |:Are you interested in messages, files, doors, or all three?        |
  2386.      |                                                                    |
  2387.      |?Are you the Sysop of a bulletin board                              |
  2388.      |                                                                    |
  2389.      |+                                                                   |
  2390.      |:What is the name of your BBS?                                      |
  2391.      |                                                                    |
  2392.      |#What is the BBS's phone number?                                    |
  2393.      |+                                                                   |
  2394.      |-                                                                   |
  2395.      |-                                                                   |
  2396.      |                                                                    |
  2397.      +--------------------------------------------------------------------+
  2398.  
  2399.      You should note that TriBBS supports a special new user questionnaire.
  2400.      This questionnaire has a file name of NEWUSER and will be presented to
  2401.      a new user after displaying a new user screen, if any.
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.      TriBBS Bulletin Board System                                        42
  2408.  
  2409.                              MULTILANGUAGE SUPPORT
  2410.                              ---------------------
  2411.  
  2412.      Almost all of the text that a caller sees when calling a TriBBS  board
  2413.      is contained in a language file called LANGUAGE.001 in node 1's  MWORK
  2414.      directory.  You can add other  languages by first creating a  language
  2415.      menu configuration file called LANGUAGE.MNU in your NWORK directory.  
  2416.      The following is an example LANGUAGE.MNU file:
  2417.  
  2418.      +--------------------------------------------------------------------+
  2419.      |TriBBS Default                                                      |
  2420.      |French                                                              |
  2421.      |German                                                              |
  2422.      |Spanish                                                             |
  2423.      +--------------------------------------------------------------------+
  2424.  
  2425.      For the above system to function  correctly, you would need to have  a
  2426.      French version  of the  TriBBS language  file called  LANGUAGE.002,  a
  2427.      German version of the TriBBS language file called LANGUAGE.003, and  a
  2428.      Spanish version of the TriBBS language file called LANGUAGE.004.   All
  2429.      of these files must reside in node 1's MWORK directory.
  2430.  
  2431.      You can also create  multilanguage display screens  and menus.   Let's
  2432.      say you want to create a French  version of bulletin number 1 for  the
  2433.      board that uses  the above  LANGUAGE.MNU file,  you would  need to  at
  2434.      least create a BULLET1.B02 file for the French ASCII bulletin and  you
  2435.      could create a BULLET1.A02  file for your French  ANSI bulletin and  a
  2436.      BULLET1.R02 for your RIP  bulletin.  German  versions would be  called
  2437.      BULLET1.B03, BULLET1.A03, and BULLET1.R03  and Spanish versions  would
  2438.      be called BULLET1.B04, BULLET1.A04, and BULLET1.R04.
  2439.  
  2440.      Multilanguage menu names are numbered in a similar manner.  If you had
  2441.      multilanguage versions of your main menu for the above example system,
  2442.      you would call them MAIN.M02 for the French version, MAIN.M03 for  the
  2443.      German version, and MAIN.M04 for the Spanish version.
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.      TriBBS Bulletin Board System                                        43
  2450.  
  2451.                               SPECIAL BATCH FILES
  2452.                               -------------------
  2453.  
  2454.      TriBBS runs a number of  batch files that allow  you to run doors  and
  2455.      perform maintenance routines at certain desirable times.
  2456.  
  2457.      ATTACH.BAT
  2458.      ----------
  2459.  
  2460.      If it exists, ATTACH.BAT is  called by TriBBS just  after a file is  a
  2461.      uploaded to  be attached  to a  message and  before it  is  optionally
  2462.      scanned for viruses.   TriBBS will pass  the uploaded file's  complete
  2463.      path name  as ATTACH.BAT's  first parameter  and the  uploaded  file's
  2464.      extension as ATTACH.BAT's second parameter.   This batch file is  very
  2465.      handy for  stripping  comments from  or  recommenting archives.    You
  2466.      should note that you do not need a call to BOARD.BAT at the end of  an
  2467.      ATTACH.BAT file.
  2468.  
  2469.      BETWEEN.BAT
  2470.      -----------
  2471.  
  2472.      If it exists,  BETWEEN.BAT is called  by TriBBS just  after a  callers
  2473.      logs off.  This  batch file is very  handy for performing  intercaller
  2474.      maintenance routines.  You should note that you do not need a call  to
  2475.      BOARD.BAT at the end of a BETWEEN.BAT file.
  2476.  
  2477.      CHAT.BAT
  2478.      --------
  2479.  
  2480.      Whenever the sysop initiates a chat, TriBBS will check for a  CHAT.BAT
  2481.      file.  If found, TriBBS will run the batch file instead of using  it's
  2482.      internal chat.   Because  TriBBS swaps  itself out  of memory  to  run
  2483.      CHAT.BAT, you shouldn't call BOARD.BAT at  the end of the CHAT.BAT  to
  2484.      rerun BBS.EXE.
  2485.  
  2486.      DOWNLOAD.BAT
  2487.      ------------
  2488.  
  2489.      If it exists, DOWNLOAD.BAT  is called by TriBBS  just after a file  is
  2490.      moved from its location in the  file area directory into the  TRANSFER
  2491.      directory.   TriBBS  will  pass  the  file's  complete  path  name  as
  2492.      DOWNLOAD.BAT's  first   parameter   and  the   file's   extension   as
  2493.      DOWNLOAD.BAT's second parameter.  This batch file is handy for  adding
  2494.      comments to  archives just  be for  the  file is  download.   This  is
  2495.      especially helpful for commenting  files off of  CD-ROMs.  You  should
  2496.      note that  you  do  not  need  a call  to  BOARD.BAT  at  the  end  of
  2497.      DOWNLOAD.BAT.
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.      TriBBS Bulletin Board System                                        44
  2504.  
  2505.      EDITOR.BAT
  2506.      ----------
  2507.  
  2508.      Whenever the caller uses the full screen editor, TriBBS will check for
  2509.      an EDITOR.BAT file.  If found, TriBBS will run the batch file  instead
  2510.      of using it's internal full screen  editor.  The external editor  must
  2511.      be of the type that supports DORINFO1.DEF, MSGINF, and MSGTMP. Because
  2512.      TriBBS swaps itself  out of memory  to run  EDITOR.BAT, you  shouldn't
  2513.      call BOARD.BAT at the end of EDITOR.BAT to rerun BBS.EXE.
  2514.  
  2515.      FASTLOG.BAT
  2516.      -----------
  2517.  
  2518.      If it exists, the FASTLOG.BAT file  is called by TriBBS if the  caller
  2519.      has used TriBBS's quick logon feature.   TriBBS creates all door  data
  2520.      files before running FASTLOG.BAT.  Unlike previous versions of TriBBS,
  2521.      starting with 10.1 you must add a BOARD.BAT at the end of  FASTLOG.BAT
  2522.      to rerun BBS.EXE.
  2523.  
  2524.      GOODBYE.BAT
  2525.      -----------
  2526.  
  2527.      Before appending  the  temporary callers  log  in NWORK  to  the  main
  2528.      callers log in  MWORK, TriBBS will  now call  an optional  GOODBYE.BAT
  2529.      file if one exists.  Because TriBBS swaps itself out of memory to  run
  2530.      GOODBYE.BAT, you shouldn't call BOARD.BAT at the end of GOODBYE.BAT to
  2531.      rerun BBS.EXE.  You  should note that the  caller is still online  and
  2532.      TriBBS generates all door files for GOODBYE.BAT.
  2533.  
  2534.      LOGON.BAT
  2535.      ---------
  2536.  
  2537.      If it exists, LOGON.BAT is called  by TriBBS just before the  bulletin
  2538.      menu is displayed.  Before exiting  from memory, TriBBS will  generate
  2539.      all of its possible door data files.
  2540.  
  2541.      NDLOGON.BAT
  2542.      -----------
  2543.  
  2544.      If it exists, the NDLOGON.BAT file is called by TriBBS just after  the
  2545.      caller logs on.  You should note that TriBBS does not create any  door
  2546.      data files for this batch file and you do not need a call to BOARD.BAT
  2547.      at the end of NDLOGON.BAT.
  2548.  
  2549.      NEWUSER.BAT
  2550.      -----------
  2551.  
  2552.      If it exists, the NEWUSER.BAT file is called by TriBBS just before the
  2553.      bulletin menu is displayed providing it  is the caller's first call.  
  2554.      Before exiting from memory, TriBBS will  generate all of its  possible
  2555.      door data files.
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.      TriBBS Bulletin Board System                                        45
  2562.  
  2563.      PAGE.BAT
  2564.      --------
  2565.  
  2566.      Whenever the caller selects <P>age, TriBBS  will check for a  PAGE.BAT
  2567.      file.  If  the batch file  is found, TriBBS  will run  the batch  file
  2568.      instead of using its internal chat.   Because TriBBS swaps itself  out
  2569.      of memory to run  PAGE.BAT, you shouldn't put  a call to BOARD.BAT  at
  2570.      the end of PAGE.BAT to rerun BBS.EXE.
  2571.  
  2572.      SECn.BAT
  2573.      --------
  2574.  
  2575.      If it exists, SECn.BAT (where "n"  is the caller's security level)  is
  2576.      called by TriBBS just before the  bulletin menu is displayed.   Before
  2577.      exiting from memory,  TriBBS will generate  all of  its possible  door
  2578.      data files.
  2579.  
  2580.      UPLOAD.BAT
  2581.      ----------
  2582.  
  2583.      If it exists,  UPLOAD.BAT is  called by TriBBS  just after  a file  is
  2584.      uploaded and before it is optionally scanned for viruses.  TriBBS will
  2585.      pass the  uploaded file's  complete path  name as  UPLOAD.BAT's  first
  2586.      parameter and  the uploaded  file's extension  as UPLOAD.BAT's  second
  2587.      parameter.  This batch file is very handy for stripping comments  from
  2588.      or recommenting archives.  You should note that you do not need a call
  2589.      to BOARD.BAT at the end of an UPLOAD.BAT file.
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.      TriBBS Bulletin Board System                                        46
  2596.  
  2597.                                    FILE LISTS
  2598.                                    ----------
  2599.  
  2600.      TriBBS maintains a file list for each file  area.  If you look at  one
  2601.      of TriBBS's binary file lists with a listing utility, they will appear
  2602.      to be a normal text  file; however, they are  formatted in such a  way
  2603.      that allows BBS.EXE to read them  very quickly.  Each line is  exactly
  2604.      78 characters long and uses the following format:
  2605.  
  2606.      +--------------------------------------------------------------------+
  2607.      |         1         2         3         4   7                        |
  2608.      |1234567890123456789012345678901234567...012345678                   |
  2609.      |FFFFFFFFFFFF SSSSSSSS MM-DD-YY DDDDDD...DDDDDDD**                   |
  2610.      |                                                                    |
  2611.      |Where:                                                              |
  2612.      |                                                                    |
  2613.      |FFFFFFFFFFFF            is the file's name.                         |
  2614.      |                                                                    |
  2615.      |SSSSSSSS                is the file's size.                         |
  2616.      |                                                                    |
  2617.      |MM-DD-YY                is the file's date.                         |
  2618.      |                                                                    |
  2619.      |DDDD...DDDD             is the file's description.                  |
  2620.      |                                                                    |
  2621.      |**                      is a carriage return/line feed pair.        |
  2622.      |                                                                    |
  2623.      |Note that a file's entry in a file list can be from 1 to 20 lines   |
  2624.      |long.                                                               |
  2625.      +--------------------------------------------------------------------+
  2626.  
  2627.      IMPORTANT: If you use a text editor for modifying your file lists, you
  2628.      must run AscToBin  on the modified  file lists or  TriBBS will not  be
  2629.      able to read them correctly.
  2630.  
  2631.      The easiest way to create a file list is to use FileMan to scan a file
  2632.      area's directory for new files.  See the description of FileMan  which
  2633.      follows.
  2634.  
  2635.      FileMan
  2636.      -------
  2637.  
  2638.      Included  with   TriBBS  is   an  external   utility  program   called
  2639.      FILEMAN.EXE.  This  utility makes it  possible to  quickly and  easily
  2640.      edit your file lists.  To run FileMan, be sure that you are in one  of
  2641.      your node's main directory and enter FILEMAN at the DOS prompt.
  2642.  
  2643.      FileMan has  an extensive  context sensitive  help  system so  a  long
  2644.      detailed explanation of its features isn't really necessary.  When  in
  2645.      doubt simply press <F1> while running FileMan.
  2646.  
  2647.      Supplied with TriBBS is a 32-bit version of FileMan that allows you to
  2648.      maintain huge file lists.   You must  have a 386SX  or better in  your
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.      TriBBS Bulletin Board System                                        47
  2655.  
  2656.      computer to run  the 32-bit  version of FileMan.   To  run the  32-bit
  2657.      version of FileMan, you must be in one of your node's main directories
  2658.      and enter FMAN32 at the DOS prompt.
  2659.  
  2660.      MakeIdx
  2661.      -------
  2662.  
  2663.      TriBBS allows  you  to optionally  search  for files  by  index  files
  2664.      instead of using the DOS directory functions.  This can greatly  speed
  2665.      up searching  large file  areas such  as CD-ROM  file areas.    Before
  2666.      MakeIdx can generate an index file  for a file area, you must  specify
  2667.      an appropriate  index file  name using  TriMan's  file area  editor.  
  2668.      MakeIdx can be run using one of the following three formats:
  2669.  
  2670.           MAKEIDX
  2671.                This will display a list box  of all of the file areas  that
  2672.                have been configured to use an index file.  Simply move  the
  2673.                highlight bar to the appropriate file area and press  enter.
  2674.                Press ESC to exit from MakeIdx.
  2675.  
  2676.           MAKEIDX /ALL
  2677.                The /ALL switch is used to  run MakeIdx from either the  DOS
  2678.                command line or from within a batch file.  This switch  will
  2679.                have MakeIdx generate  index files for  any file areas  that
  2680.                are configured to use index files.
  2681.  
  2682.           MAKEIDX /F:n1[-n2]
  2683.                The /F: switch is  used to run MakeIdx  from either the  DOS
  2684.                command line or from within a batch file.  This switch  will
  2685.                have MakeIdx generate  an index  file for  a specified  file
  2686.                area if it is  specified using /F:n1, where  n1 is the  file
  2687.                area to be indexed.   The /F: switch  can also create  index
  2688.                files for a  range of file  areas if it  is specified  using
  2689.                /F:n1-n2, where n1 is the first file area to be indexed  and
  2690.                n2 is the last file area to be indexed.
  2691.  
  2692.      IMPORTANT: You should not use an index file for an upload file area.  
  2693.      The reason for this is because TriBBS will only search the index  file
  2694.      for matching files if the file  area is configured as an indexed  file
  2695.      area.  Therefore, a  file that was uploaded  after the index file  was
  2696.      created cannot be  found until the  file area is  re-indexed.  So  the
  2697.      best use for indexed file areas is to index any large file areas  that
  2698.      don't serve as upload  areas.  Then  you will only  have to reindex  a
  2699.      particular file area when you add or move  a file to it. Note that  it
  2700.      is possible to index an upload area by either running MakeIdx on  your
  2701.      upload file areas either  in an UPLOAD.BAT or  BETWEEN.BAT file.   You
  2702.      should also note that once you have  built an index for a CD-ROM  file
  2703.      area you will  not have  to ever rebuild  it because  the file  area's
  2704.      directory will never change on a  CD-ROM.  One last note, MakeIdx  can
  2705.      build an index file for any  file area that has  up to 15000 files  in
  2706.      its directory.
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.      TriBBS Bulletin Board System                                        48
  2713.  
  2714.      Master
  2715.      ------
  2716.  
  2717.      TriBBS/Pro supports another file indexing  system that is much  faster
  2718.      than the MakeIdx index system.  This optional file indexing system  is
  2719.      called master indexing and  can build a single  index file for all  of
  2720.      the file areas that you wish to include in the master index. To create
  2721.      a master index, you must toggle  the file area configuration's  Master
  2722.      Index toggle to  "Yes" for  any file areas  you want  included in  the
  2723.      master index.   Next you  must run  MASTER at  the DOS  prompt from  a
  2724.      node's main directory.  As with MakeIdx, you should not include upload
  2725.      file areas in your master index.
  2726.  
  2727.      AscToBin
  2728.      --------
  2729.  
  2730.      Included in the  TriBBS archives is  a program  called ASCTOBIN.EXE.  
  2731.      When this program is run,  it will convert an  ASCII file list to  the
  2732.      special binary format that TriBBS uses to read and display file  lists
  2733.      as fast as  possible.  AscToBin  is run from  one of  your nodes  main
  2734.      directories and is run in one of three modes.  It can be run with  the
  2735.      following command lines:
  2736.  
  2737.           ASCTOBIN
  2738.                This will display  a list  box of all  of the  file areas.  
  2739.                Simply move the highlight bar  to the appropriate file  area
  2740.                and press ENTER.  Press ESC to exit from AscToBin.
  2741.  
  2742.           ASCTOBIN /ALL
  2743.                The /ALL switch is used to run AscToBin from either the  DOS
  2744.                command line or from within a batch file.  This switch  will
  2745.                have AscToBin convert the file lists for all of the  board's
  2746.                file areas.
  2747.  
  2748.           ASCTOBIN /F:n1[-n2]
  2749.                The /F: switch is used to  run AscToBin from either the  DOS
  2750.                command line or from within a batch file.  This switch  will
  2751.                have AscToBin convert  the file lists  for a specified  file
  2752.                area if it is  specified using /F:n1, where  n1 is the  file
  2753.                list to generate the binary file  list for.  The /F:  switch
  2754.                can also create binary file lists for a range of file  areas
  2755.                if it is  specified using /F:n1-n2,  where n1  is the  first
  2756.                file area to  create a binary  file list for  and n2 is  the
  2757.                last file area to create a binary file list for.
  2758.  
  2759.      IMPORTANT: AscToBin  does not  support file  sharing.   Therefore,  it
  2760.      should only be run whenever all of the  BBS's nodes are down.  If  you
  2761.      edit your file lists with a text editor, you must run AscToBin on  all
  2762.      modified file lists or  TriBBS will not be  able to properly read  and
  2763.      display the file lists.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.      TriBBS Bulletin Board System                                        49
  2770.  
  2771.      List Converter
  2772.      --------------
  2773.  
  2774.      List Converter is used  to convert files lists  for BBS systems  other
  2775.      than TriBBS  to  the TriBBS  10.1  file  list format.    Because  List
  2776.      Converter uses a collection of templates to determine the foreign file
  2777.      list format, it can convert virtually any file list.  You should  note
  2778.      that List  Converter will  only work  for registered  TriBBS 10.1  Pro
  2779.      sysops.
  2780.  
  2781.      Because List Converter will only work  for registered TriBBS 10.1  Pro
  2782.      sysops, it must be run for a node's main directory.
  2783.  
  2784.      Running List Converter
  2785.      ----------------------
  2786.  
  2787.      List Converter is run by simply  entering LISTCVT at the DOS prompt.  
  2788.      You will notice that near  the top of the  screen there are two  black
  2789.      lines.  The top black line is the sample file list display line.   The
  2790.      bottom black line is the template  display line. The template  display
  2791.      line will  contain the  first template  in List  Converter's  template
  2792.      file.  Because  most CDs  come with PCBoard  file lists  on them,  the
  2793.      first template displayed is the PCBoard  file list template. To get  a
  2794.      list of  control keys  that List  Converter  supports and  a  detailed
  2795.      description of  each  key's function,  simply  bring up  the  context-
  2796.      sensitive help screen by pressing <F1>.
  2797.  
  2798.      Notes About List Converter
  2799.      --------------------------
  2800.  
  2801.      Although List  Converter  does an  excellent  job of  converting  file
  2802.      lists, it's not perfect.  Some BBS file list formats permit headers in
  2803.      the file lists.  If the file  lists you want to convert have  headers,
  2804.      they will  have to  be  removed manually  with  a text  editor  before
  2805.      running  List  Converter.    List  Converter  will  not  word  wrap  a
  2806.      description as long as the description's  first line is 45  characters
  2807.      or less.    List  Converter  will  assume  that  a  02H  byte  in  the
  2808.      description is a line break.
  2809.  
  2810.      User-Defined Templates
  2811.      ----------------------
  2812.  
  2813.      Because List  Converter  allows  you to  define  your  own  file  list
  2814.      templates, it can convert virtually any  file list out there.  If  you
  2815.      do create templates of your own, please upload your TEMPLATE.TXT  file
  2816.      to Freejack's Software so  that  your  user-defined  templates can  be
  2817.      included  in future  releases  of the  List  Converter  template file.
  2818.      Please try to name the templates  as to  the type  of BBS  software or
  2819.      CD that  the original file list came from.
  2820.  
  2821.      Offline File Areas
  2822.      ------------------
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.      TriBBS Bulletin Board System                                        50
  2829.  
  2830.  
  2831.      TriBBS/Pro support offline file areas.  This is particularly useful if
  2832.      you have a lot of CDs, but only have a single CD-ROM drive.  To  setup
  2833.      a file  area  as  an offline  file  area,  simple set  the  file  area
  2834.      configuration Offline File Area  toggle to "Yes" for  the file area.  
  2835.      Next you need to assign a "disc number" in the file area's Disc Number
  2836.      field.
  2837.  
  2838.      IMPORTANT: For TriBBS to be able to recognize that there are files  in
  2839.      the offline file area, you must  index the file area either using  the
  2840.      master indexing system or the MakeIdx indexing system.
  2841.  
  2842.      Putting Requested Files Online
  2843.      ------------------------------
  2844.  
  2845.      Whenever a caller has  requested an offline file,  TriBBS will add  an
  2846.      entry to a file called REQUEST.TXT in node 1's MWORK directory.  These
  2847.      requests can be processed by running the program REQUEST in any node's
  2848.      main directory.    Request will  prompt  you to  insert  CDs  whenever
  2849.      necessary.   It will  place each  requested file  in the  file  area's
  2850.      upload area, update the file list for the upload file area, and send a
  2851.      private message to the  caller who requested the  file that it is  now
  2852.      online.
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.      TriBBS Bulletin Board System                                        51
  2859.  
  2860.                                EXTERNAL PROTOCOLS
  2861.                                ------------------
  2862.  
  2863.      TriBBS supports  up to  15 external  protocols.   To  enable  external
  2864.      protocols, you must edit the external protocol menu configuration file
  2865.      via TriMan.
  2866.  
  2867.      The following is an example of an EXTPROT.MNU file:
  2868.  
  2869.      +--------------------------------------------------------------------+
  2870.      |z,Zmodem (DSZ),sz.bat,rz.bat,y,n                                    |
  2871.      |m,MPt (Puma),smpt.bat,rmpt.bat,y,n                                  |
  2872.      |h,HS/Link,hss.bat,hsr.bat,y,n                                       |
  2873.      +--------------------------------------------------------------------+
  2874.  
  2875.      This example file replaces TriBBS's internal Zmodem protocol with DSZ,
  2876.      adds  the  very   speedy  MPt   (formerly  Puma),   and  the   speedy,
  2877.      bidirectional protocol HS/Link to the board's list of protocols.   All
  2878.      three protocols support batch  downloads and none  of them require  an
  2879.      error correcting connection.
  2880.  
  2881.      Send Batch Files
  2882.      ----------------
  2883.  
  2884.      When TriBBS calls  a send batch  file, it passes  the following  three
  2885.      parameters to the batch file:
  2886.  
  2887.      +--------------------------------------------------------------------+
  2888.      |port number  baud rate  filename or EBATCH.DAT                      |
  2889.      +--------------------------------------------------------------------+
  2890.  
  2891.      The  "port  number"  and  "baud  rate"  parameters  are  pretty   self
  2892.      explanatory.   The third  parameter TriBBS  passes to  the batch  file
  2893.      requires a  little  further explanation.    If the  protocol,  doesn't
  2894.      support batch downloads, TriBBS only passes a single "filename" to the
  2895.      protocol.  Otherwise,  TriBBS creates a  file called "EBATCH.DAT"  and
  2896.      passes  the  name  of  the  file  to  the  protocol's  batch  file.   
  2897.      "EBATCH.DAT" is  simply a  line-by-line listing  of the  files in  the
  2898.      batch download.
  2899.  
  2900.      The following is an example of a DSZ send batch file called SZ.BAT:
  2901.  
  2902.      +--------------------------------------------------------------------+
  2903.      |dsz port %1 sz -m @c:%3                                             |
  2904.      +--------------------------------------------------------------------+
  2905.  
  2906.      Note that the above batch file enables MobyTurbo transfers.
  2907.  
  2908.      The following is an example of a MPt send batch file called SMPT.BAT:
  2909.      +--------------------------------------------------------------------+
  2910.      |mpt p%1 s  @%3                                                      |
  2911.      +--------------------------------------------------------------------+
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.      TriBBS Bulletin Board System                                        52
  2918.  
  2919.  
  2920.      The following  is an  example  of a  HS/Link  send batch  file  called
  2921.      HSS.BAT:
  2922.  
  2923.      +--------------------------------------------------------------------+
  2924.      |hslink -p%1 @%3                                                     |
  2925.      +--------------------------------------------------------------------+
  2926.  
  2927.      Receive Batch Files
  2928.      -------------------
  2929.  
  2930.      When TriBBS calls a receive batch file, it passes the following  three
  2931.      parameters to the batch file:
  2932.  
  2933.      +--------------------------------------------------------------------+
  2934.      |port number  baud rate  filename                                    |
  2935.      +--------------------------------------------------------------------+
  2936.  
  2937.      IMPORTANT: You should note that the "filename" parameter is not passed
  2938.      to external protocols that support batch file transfers.
  2939.  
  2940.      The following is an example of a DSZ receive batch file called RZ.BAT:
  2941.  
  2942.      +--------------------------------------------------------------------+
  2943.      |dsz port %1 rz -mrr                                                 |
  2944.      +--------------------------------------------------------------------+
  2945.  
  2946.      Note that the above batch file enables MobyTurbo transfers.
  2947.  
  2948.      The following  is  an example  of  a  MPt receive  batch  file  called
  2949.      RMPT.BAT:
  2950.  
  2951.      +--------------------------------------------------------------------+
  2952.      |mpt p%1 r                                                           |
  2953.      +--------------------------------------------------------------------+
  2954.  
  2955.      The following is  an example of  a HS/Link receive  batch file  called
  2956.      HSR.BAT:
  2957.  
  2958.      +--------------------------------------------------------------------+
  2959.      |hslink -p%1                                                         |
  2960.      +--------------------------------------------------------------------+
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.      TriBBS Bulletin Board System                                        53
  2967.  
  2968.                                   FILE RATIOS
  2969.                                   -----------
  2970.  
  2971.      File/Byte Ratios (Security Level Stays the Same)
  2972.      ------------------------------------------------
  2973.  
  2974.      TriBBS also  a  file/byte ratio  method  that restricts  the  caller's
  2975.      ability to download if  he has exceeded  his file or  byte ratio.   To
  2976.      setup your  system so  that it  will restrict  a caller's  ability  to
  2977.      download to their ratios, you must edit your ratios configuration  via
  2978.      TriMan.
  2979.  
  2980.      The following is an example a RATIOS.DAT file:
  2981.  
  2982.      +--------------------------------------------------------------------+
  2983.      |30,10,20                                                            |
  2984.      |20,5,10                                                             |
  2985.      +--------------------------------------------------------------------+
  2986.  
  2987.      Note from this  example that a  level 30 caller  must maintain a  file
  2988.      ratio of 1 upload for every 10 downloads and a byte ratio of 1K  bytes
  2989.      uploaded for  every 20K  bytes downloaded.   If  the caller  fails  to
  2990.      maintain these levels he  will not be able  to download anymore  files
  2991.      until he uploads a sufficient number  of files or bytes to restore  is
  2992.      file/byte ratios to the required level.
  2993.  
  2994.      File/Byte Ratios (Adjusting Security Levels)
  2995.      --------------------------------------------
  2996.  
  2997.      To optionally  setup  your system  so  that it  will  adjust  callers'
  2998.      security levels  according to  their ratios,  you must  first set  the
  2999.      ratios type  toggle in  your system  configuration via  TriMan to  the
  3000.      appropriate settings.  Next you must edit the ratios configuration via
  3001.      TriMan.
  3002.  
  3003.      The following is an example of a RATIOS.DAT file:
  3004.  
  3005.      +--------------------------------------------------------------------+
  3006.      |30,5.5,7.5                                                          |
  3007.      |20,10,20                                                            |
  3008.      |15,20,30                                                            |
  3009.      +--------------------------------------------------------------------+
  3010.  
  3011.      Note from this example  that you can  specify both a  file and a  byte
  3012.      ratio for each security level and you can also use decimals to specify
  3013.      the ratios.  In this  example, a caller with  a security level of  30,
  3014.      must maintain  a  file  ratio of  at  least  1 upload  per  every  5.5
  3015.      downloads and must  maintain a  byte ratio  of 1K  bytes uploaded  per
  3016.      every 7.5K  bytes downloaded.   If  the  caller can't  maintain  these
  3017.      ratios, TriBBS will downgrade the caller  to a 20 security level.   If
  3018.      the caller can't  maintain a 20  security level,  TriBBS will  further
  3019.      downgrade the caller to a 15  security level.  Finally, if the  caller
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.      TriBBS Bulletin Board System                                        54
  3026.  
  3027.      can't maintain a 15 security level,  TriBBS will not allow the  caller
  3028.      to download any more files until he has uploaded enough files to  meet
  3029.      his security level.
  3030.  
  3031.      You should note that a caller's ratios are checked at logon and  after
  3032.      every upload and download.
  3033.  
  3034.      Free Downloads
  3035.      --------------
  3036.  
  3037.      Often times, a BBS has  a number of files  that the sysops would  like
  3038.      all callers to  be able to  download without the  files being  counted
  3039.      towards the caller's file and/or byte ratio.  You can accomplish  this
  3040.      with TriBBS by editing your free files configuration via TriMan.   The
  3041.      following is an example of a FREE.DAT file:
  3042.  
  3043.      c:\tribbs\tribbs\*.*
  3044.      r*.*
  3045.  
  3046.      In the above example, TriBBS will  consider any files that are in  the
  3047.      directory "c:\tribbs\tribbs" and any files  starting with "r" as  free
  3048.      downloads.
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.      TriBBS Bulletin Board System                                        55
  3055.  
  3056.                               SUBSCRIPTION SYSTEM
  3057.                               -------------------
  3058.  
  3059.      TriBBS supports an optional  subscription system.   The first step  in
  3060.      setting  up  a  subscription  system  is  to  edit  the   subscription
  3061.      configuration via TriMan.
  3062.  
  3063.      The following is an example of a subscription configuration file:
  3064.  
  3065.      +--------------------------------------------------------------------+
  3066.      |30,10                                                               |
  3067.      +--------------------------------------------------------------------+
  3068.  
  3069.      Note from this example that  a level 30 caller  would be reduced to  a
  3070.      level 10 as soon as his  subscription has expired.  TriBBS checks  for
  3071.      an expired subscription at logon.   A subscription expiration date  is
  3072.      set for an individual caller through  the Waiting for Caller  screen's
  3073.      Edit User function.
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.      TriBBS Bulletin Board System                                        56
  3080.  
  3081.                   RUNNING TRIBBS WITH A FRONTEND OR AS A DOOR
  3082.                   -------------------------------------------
  3083.  
  3084.      TriBBS can be  run with either  a frontend  program (i.e.,  FrontDoor,
  3085.      BinkleyTerm, etc.) or  as a  door.  To  execute TriBBS  when there  is
  3086.      already a connection, you must specify the connection's baud rate with
  3087.      TriBBS's "/F" command line switch.   The format for using this  switch
  3088.      is "/Fbaud rate".  Where "baud  rate" is the connection's baud rate.  
  3089.      For example, TriBBS could be executed with a 2400 baud connection with
  3090.      the following command line:
  3091.  
  3092.      BBS /F2400
  3093.  
  3094.      The above  is only  an example  and you  should use  BOARD.BAT to  run
  3095.      TriBBS as  you normally  would.   Otherwise, doors  will not  function
  3096.      properly.  To do this, modify your BOARD.BAT file as follows:
  3097.  
  3098.      +--------------------------------------------------------------------+
  3099.      |echo off                                                            |
  3100.      |cd \tribbs                                                          |
  3101.      |if exist door.bat del door.bat                                      |
  3102.      |if exist event.bat del event.bat                                    |
  3103.      |if exist endbbs del endbbs                                          |
  3104.      |bbs %1                                                              |
  3105.      |if exist door.bat door                                              |
  3106.      |if exist event.bat event                                            |
  3107.      |if exist endbbs goto end                                            |
  3108.      |board                                                               |
  3109.      |:end                                                                |
  3110.      +--------------------------------------------------------------------+
  3111.  
  3112.      Note the "%1"  after "bbs" in  the above batch  file.   This will  use
  3113.      BOARD.BAT's first command line  parameter to pass  the "/F" switch  to
  3114.      TriBBS.   For  example,  you could  execute  TriBBS  using  the  above
  3115.      BOARD.BAT file with a 2400 baud connection by using the following  DOS
  3116.      command:
  3117.  
  3118.      BOARD /F2400
  3119.  
  3120.      Normally, TriBBS will recycle  to the Waiting  for Caller screen  when
  3121.      the caller either logs off or is forced  off the board.  If TriBBS  is
  3122.      started with  a "/F"  parameter, TriBBS  will exit  memory and  return
  3123.      control to the calling  program.  Thus, TriBBS  acts just like a  door
  3124.      when a "/F" parameter is used.
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.      TriBBS Bulletin Board System                                        57
  3131.  
  3132.      IMPORTANT: Although doors run fine when  using TriBBS in this  manner,
  3133.      events are  always  executed by  TriBBS's  Waiting for  Caller  screen
  3134.      routine. Therefore, events will never run if TriBBS is being run  with
  3135.      the "/F" parameter.  If your board requires maintenance events and you
  3136.      are using  TriBBS  with a  frontend  program,  simply run  them  as  a
  3137.      frontend event.  If you are running TriBBS as a door, simply let  your
  3138.      main board run the necessary events.
  3139.  
  3140.      Error Correcting Connections
  3141.      ----------------------------
  3142.  
  3143.      If your frontend is able to  supply an error correcting message  (i.e.
  3144.      ARQ, etc.), it may  be specified with a  slightly modified version  of
  3145.      TriBBS's "/F"  command line  switch:  "/F baud  rate/error  correcting
  3146.      message".  Please note  the slash between the  "baud rate" and  "error
  3147.      correcting message" parameters.  This slash is essential for TriBBS to
  3148.      be able to correctly parse the "/F" command line switch.
  3149.  
  3150.      Limiting Time
  3151.      -------------
  3152.  
  3153.      A user's log on  time can be limited  with TriBBS's "/T" command  line
  3154.      switch.  The  format for  this command  line switch  is "/Tminutes".  
  3155.      Where "minutes" is the maximum number of minutes the caller should  be
  3156.      allowed for this call.
  3157.  
  3158.      Forced Hang Up
  3159.      --------------
  3160.  
  3161.      Normally, TriBBS does not hang up on the caller when he says  goodbye.
  3162.       It leaves the task of hanging up to the frontend program or the  main
  3163.      board.  If your frontend doesn't hang up before recycling, you can use
  3164.      TriBBS's "/H" command  line switch to  instruct it to  hang up on  the
  3165.      caller before returning to the frontend.
  3166.  
  3167.      IMPORTANT: Whenever  a caller  is in  a door,  TriBBS creates  a  file
  3168.      called DOORS.TMP in the node's NWORK directory.  TriBBS uses this file
  3169.      to determine if  a caller  is returning from  a door  when BBS.EXE  is
  3170.      restarted.  Therefore, it is essential that your frontend's batch file
  3171.      delete DOORS.TMP before running BOARD.BAT.   Otherwise, if carrier  is
  3172.      lost in a door, BBS.EXE will assume that a caller is returning from  a
  3173.      door when the frontend program calls it the next time.   Consequently,
  3174.      the next caller will be logged on under the previous caller's account.
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.      TriBBS Bulletin Board System                                        58
  3181.  
  3182.  
  3183.                                  ODDS AND ENDS
  3184.                                  -------------
  3185.  
  3186.      @USER@ Messages
  3187.      ---------------
  3188.  
  3189.      Anybody with  at least  a minimum  sysop  security level  can  address
  3190.      messages to @USER@ in  local message conferences.   When a message  is
  3191.      addressed in  this fashion,  it will  appear to  the caller  that  the
  3192.      message was  addressed to  him personally  and all  callers that  have
  3193.      access to  the  message conference  will  have their  waiting  message
  3194.      counters for the conference incremented to  indicate that they have  a
  3195.      message waiting for them in the appropriate conference.
  3196.  
  3197.      Multidisc CD-ROM Drives
  3198.      -----------------------
  3199.  
  3200.      TriBBS supports CD-ROM  drives that have  multiple CDs,  but only  one
  3201.      laser (e.g.,  Pioneer drives).   This  feature is  only enabled  if  a
  3202.      CDWAIT environment variable is defined before running BOARD.BAT and is
  3203.      only necessary if you're running such a drive on a multinode system.  
  3204.      This feature can be  enabled by putting a  line like the following  in
  3205.      your AUTOEXEC.BAT file:
  3206.  
  3207.           SET CDWAIT=TRUE
  3208.  
  3209.      DSZLOG Logging
  3210.      --------------
  3211.  
  3212.      TTPROT.EXE will  produce DSZ-style  logs  by setting  the  environment
  3213.      variable DSZLOG to the name of  the file that you want TTPROT.EXE  and
  3214.      any external protocols that  support DSZ-style logs  to write the  log
  3215.      file to.   For  example, you  could  use the  following line  in  your
  3216.      BOARD.BAT file:
  3217.  
  3218.           SET DSZLOG=C:\TRIBBS\DSZ.LOG
  3219.  
  3220.      You should note that on multinode systems the name of the DSZLOG  file
  3221.      must be unique  for each node.   Furthermore, you  should not set  the
  3222.      file name  to  the CALLERS.LOG  file  in  either the  NWORK  or  MWORK
  3223.      directories.
  3224.  
  3225.      In addition to providing additional  log information, this feature  is
  3226.      handy for  catching  callers  who  try  to  beat  ratios  by  aborting
  3227.      transfers with the final file in a large batch transfer.  Whenever,  a
  3228.      download is aborted, TriBBS  will try to locate  a DSZLOG file and  if
  3229.      one is found TriBBS  will extract the information  it needs from  this
  3230.      log file to determine what files the caller actually downloaded during
  3231.      the batch transfer.
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.      TriBBS Bulletin Board System                                        59
  3238.  
  3239.      Special Keys
  3240.      ------------
  3241.  
  3242.      There are a number of special keys that you can used while a caller is
  3243.      logged on to your board.  They are as follows:
  3244.  
  3245.      +--------------------------------------------------------------------+
  3246.      |Key           Description                                           |
  3247.      +--------------------------------------------------------------------+
  3248.      |<F1>          Adds 5 minutes to the caller's time.                  |
  3249.      |<F2>          Takes 5 minutes away from the caller's time.          |
  3250.      |<F3>          Toggles the page bell on and off.  This key is        |
  3251.      |              functional while somebody is online and at the waiting|
  3252.      |              for caller screen.                                    |
  3253.      |<F4>          Will allow you to adjust the caller's security level. |
  3254.      |              TriBBS will prompt you to enter the caller's new      |
  3255.      |              security level.                                       |
  3256.      |<F5>          Logs the caller off.                                  |
  3257.      |<F6>          Logs the caller off and marks his user record as      |
  3258.      |              "Locked Out".                                         |
  3259.      |<F7>          Logs the caller off with a "Keyboard input time       |
  3260.      |              exceeded" message.                                    |
  3261.      |<F8>          Displays a screen called either NUKE.BBS or NUKE.ANS  |
  3262.      |              and hangs up on the caller.                           |
  3263.      |<F9>          After the caller logs off, TriBBS will stop execution |
  3264.      |              and return to DOS.  Once <F9> has been pressed, TriBBS|
  3265.      |              will display a blinking down arrow in the lower right |
  3266.      |              hand corner of the user status window.  The automatic |
  3267.      |              shut down can be overridden pressing <F9> again.  Note|
  3268.      |              that TriBBS will exit with an errorlevel of 2 if the  |
  3269.      |              F9 key has been pressed.                              |
  3270.      |<HOME>        Toggles between the two caller status windows at the  |
  3271.      |              bottom of the display screen and two help screens     |
  3272.      |              about the above mentioned function keys.              |
  3273.      |<ALT><C>      Enters chat mode.  The chat can be ended by pressing  |
  3274.      |              <ESC>.                                                |
  3275.      |<ALT><D>      Allows you to drop to DOS.                            |
  3276.      +--------------------------------------------------------------------+
  3277.  
  3278.      Quick Logon
  3279.      -----------
  3280.  
  3281.      TriBBS allows you to enter both  your name and password at the  "Enter
  3282.      your name" prompt.  Simply separate your name from the password with a
  3283.      semicolon <;>.  For example, a caller with the name  Gary Price  and a
  3284.      password of Install  could enter  his name  and password  at the  name
  3285.      prompt as follows:
  3286.  
  3287.           Gary Price;Install
  3288.  
  3289.      You should  note that  for security  reasons TriBBS  will display  the
  3290.      password as a series of periods <.>.
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.      TriBBS Bulletin Board System                                        60
  3297.  
  3298.      If the caller's security level is  greater or equal to the Fast  Logon
  3299.      security level in  the board's  system configuration,  the caller  can
  3300.      bypass all logon  screens, logon batch  files, and  bulletin menus  by
  3301.      preceding his or  her name  with an  asterisk <*>.     For example,  a
  3302.      caller with the name of  Gary Price  and a  password of Install  could
  3303.      do logon and go  straight to the  main menu by  entering his name  and
  3304.      password at the name prompt as follows:
  3305.  
  3306.           *Gary Price;Install
  3307.  
  3308.      File Flagging
  3309.      -------------
  3310.  
  3311.      While displaying  a file  listing, the  "more" prompt  will allow  the
  3312.      caller to flag files for downloading  by simply pressing <F>.   TriBBS
  3313.      will prompt the caller  to enter letters that  are displayed with  the
  3314.      appropriate files in the listing.
  3315.  
  3316.      Packing the Message Base
  3317.      ------------------------
  3318.  
  3319.      You may have noticed  that included with your  TriBBS files is a  file
  3320.      called TRIPACK.EXE.  TriPack  is the TriBBS message  base packer.   It
  3321.      will remove any <DELETED>  messages and messages  that are older  than
  3322.      the number  of days  you have  indicated in  your message  conferences
  3323.      setup.   TriPack was  developed as  an external  program in  order  to
  3324.      permit you to pack your message base as an event.  TriPack is a fairly
  3325.      easy program to  use and can  be executed with  the following  command
  3326.      line:
  3327.  
  3328.      TRIPACK /P /R /C:range
  3329.  
  3330.  
  3331.      Where:
  3332.  
  3333.      /P                       is an  optional switch.   If  specified,  all
  3334.                               messages marked  <PRIVATE><RECEIVED> will  be
  3335.                               deleted.
  3336.  
  3337.      /R                       is an  optional switch.   If  specified,  the
  3338.                               message base conference will be renumbered.  
  3339.                               TriBBS support  message  numbers as  high  as
  3340.                               999,999.  You should only renumber a  message
  3341.                               base conference if  you think the  conference
  3342.                               will rollover this  amount.  Although  TriBBS
  3343.                               will update its  message threads  internally,
  3344.                               net mail message  threads may be  lost.   For
  3345.                               example, PCRelay maintains a list of  message
  3346.                               threads for each  netmail conference.   After
  3347.                               renumbering your message conference,  PCRelay
  3348.                               will not be able  to correctly indicate if  a
  3349.                               message has been replied to or not.
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.      TriBBS Bulletin Board System                                        61
  3356.  
  3357.      /C:range                 is an optional switch.  It is used to specify
  3358.                               either a  single  conference or  a  range  of
  3359.                               conferences  to   be   packed.     A   single
  3360.                               conference is packed by specifying its number
  3361.                               after the ":".  For example, /C:4 would  pack
  3362.                               message conference 4.  A range of conferences
  3363.                               can be packed by separating them with a  "-".
  3364.                                For  example,  /C:5-9   will  pack   message
  3365.                               conferences 5 through 9.
  3366.  
  3367.      IMPORTANT: Never pack a system's message base unless the entire system
  3368.      is down.
  3369.  
  3370.      The TriBBS Protocol Driver: TTPROT.EXE
  3371.      --------------------------------------
  3372.  
  3373.      The file TTPROT.EXE  is the protocol  driver TriBBS  calls to  perform
  3374.      file transfers.  In order for TriBBS to be able to run TTPROT.EXE,  it
  3375.      must be in your  DOS PATH.  This  is very important!   If it isn't  in
  3376.      your PATH, file transfers will always abort.
  3377.  
  3378.      Multitasker Awareness
  3379.      ---------------------
  3380.  
  3381.      On startup, BBS.EXE will  attempt to detect if  it is running under  a
  3382.      multitasking operating  system  (OS/2)  or  a  multitasking  operating
  3383.      environment (DesqView or  Windows).  You  can override this  automatic
  3384.      multitasker detection with one of  the following BBS.EXE command  line
  3385.      switches:
  3386.  
  3387.      +--------------------------------------------------------------------+
  3388.      |Switch                  Action                                      |
  3389.      +--------------------------------------------------------------------+
  3390.      |/MD                     Force BBS.EXE to use DesqView awareness.    |
  3391.      |/MN                     Force BBS.EXE to not use any multitasker    |
  3392.      |                        awareness.                                  |
  3393.      |/MO                     Force BBS.EXE to use OS/2 awareness.        |
  3394.      |/MW                     Force BBS.EXE to use Windows awareness.     |
  3395.      +--------------------------------------------------------------------+
  3396.  
  3397.      Archive Testing
  3398.      ---------------
  3399.  
  3400.      TriBBS can optionally scan archives, EXEs, and COMs for viruses.  This
  3401.      feature is enabled by  setting the appropriate  toggle in your  system
  3402.      configuration via TriMan.
  3403.  
  3404.      Fossil Driver Support
  3405.      ---------------------
  3406.  
  3407.      Normally, TriBBS  communicates  with  the  computer's  modem  directly
  3408.      through the computers  serial port.   However,  TriBBS can  optionally
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.      TriBBS Bulletin Board System                                        62
  3415.  
  3416.      support communication with the modem  through a fossil driver.  Fossil
  3417.      support is a TriBBS/Pro feature only  and can be enabled in your  node
  3418.      configuration via TriMan.
  3419.  
  3420.      IMPORTANT: If  you  have enabled  fossil  driver support,  you  should
  3421.      rename the file FTTPROT.EXE to TTPROT.EXE.  FTTPROT.EXE is the  fossil
  3422.      driver version of TTPROT.EXE and must be used for the proper  transfer
  3423.      of files.
  3424.  
  3425.      Caller ID Support
  3426.      -----------------
  3427.  
  3428.      TriBBS/Pro supports  caller id.  To use  caller  id, your  modem  must
  3429.      provide support for caller id and you must have caller id activated by
  3430.      your telephone company. Most modems use the command AT#CID=1 to enable
  3431.      caller id. You should consult your  modem's manual to verify this.  If
  3432.      you are unsure if your modem supports caller id or the correct command
  3433.      to enable caller id,  you need to  contact your modem's  manufacturer.
  3434.      After adding the proper command to  the modem's init string to  enable
  3435.      caller id support, you  must enable it in  your node configuration  by
  3436.      selecting the appropriate toggle. Because the caller id information is
  3437.      sent between  the first  and second  rings, you  must set  the  node's
  3438.      number of rings to 2.
  3439.  
  3440.      Phone numbers can  be twitted out  by creating an  ASCII text file  in
  3441.      node 1's MWORK directory named CID.DAT  and listing the twitted  phone
  3442.      numbers one line at a time.
  3443.  
  3444.      TriBBs has  a  /# BBS.EXE,  command  line  switch to  pass  caller  id
  3445.      information from  a frontend  program to  TriBBS.  It will  require  a
  3446.      third-party utility to parse the information  that is passed from  the
  3447.      frontend program to BBS.EXE using the following format:
  3448.  
  3449.      +--------------------------------------------------------------------+
  3450.      |/#                      or don't use the /# switch at all to        |
  3451.      |                        indicate no CID info.                       |
  3452.      |/#P                     for a blocked call.                         |
  3453.      |/#O                     for an out of area call.                    |
  3454.      |/#2079459346            the phone number.                           |
  3455.      +--------------------------------------------------------------------+
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.      TriBBS Bulletin Board System                                        63
  3462.  
  3463.                                    MULTINODES
  3464.                                    ----------
  3465.  
  3466.      Setting up a multinode TriBBS board  is a pretty easy procedure.   You
  3467.      must first create  a directory for  your new node.   For example,  you
  3468.      might create  a  directory called  C:\TRIBBS2  for the  second  node's
  3469.      directory.  Now you must copy  your SYSDAT2.DAT file from your node  1
  3470.      directory to your new node's directory.  You also need to copy all  of
  3471.      the *.EXE and  *.HLP files  from node 1's  main directory  to the  new
  3472.      node's directory.   Next  change your  current  directory to  the  new
  3473.      node's directory and run BBS.EXE.  Immediately exit from BBS.EXE.  You
  3474.      now have a second node.  You  should now use TriMan to configure  your
  3475.      new node.
  3476.  
  3477.      Upon returning to DOS, you must  create a BOARD.BAT file for your  new
  3478.      node.  The simplest  method for doing  this is to  copy your node  1's
  3479.      BOARD.BAT file to the new node's directory and edit it  appropriately.
  3480.      About the  only change  you'll have  to  make is  to edit  the  change
  3481.      directory command (i.e. cd \tribbs) near the top of you BOARD.BAT file
  3482.      to change the directory to the new node's directory.
  3483.  
  3484.      Next, you will  need new menu  configuration files in  the new  node's
  3485.      NWORK directory.  Once again, you  can simply copy node 1's MNU  files
  3486.      and edit them appropriately.
  3487.  
  3488.      The process for setting up a  third, fourth, fifth, etc. node is  just
  3489.      like the above.  You simply set up another directory and repeat all of
  3490.      the above steps.
  3491.  
  3492.      How Do I Get the System Up and Running
  3493.      --------------------------------------
  3494.  
  3495.      To get multiple nodes  up and running on  the same computer, you  will
  3496.      need to use a multitasker and have a 386 or better to do it.  TriBBS  
  3497.      10.1 can been  successfully run under  DesqView, Windows 3.x,  Windows
  3498.      95, Windows NT, or OS/2 2.0. 
  3499.  
  3500.      IMPORTANT: So that TriBBS's data file  will not be written to by  more
  3501.      than one  node at  a time,  TriBBS fully  supports file  sharing.   To
  3502.      enable file  sharing,  you must  put  the command  SHARE.EXE  in  your
  3503.      AUTOEXEC.BAT file.  SHARE.EXE is a terminate and stay resident program
  3504.      that comes with DOS that handles record locking.  Without SHARE.EXE in
  3505.      memory, TriBBS does not have the ability to correctly lock and  unlock
  3506.      the system data files and sooner or later they will become  corrupted.
  3507.       For some strange quirk unique to Windows 3.x, you must have SHARE.EXE
  3508.      in memory to run TriBBS under Windows  3.x.  This is true whether  you
  3509.      are running a single or multinode system under Windows 3.x.  Also note
  3510.      that Windows 95, Windows NT, and OS/2 have record locking built  right
  3511.      into the operating system; therefore,  SHARE.EXE is not required  when
  3512.      multitasking TriBBS with Windows, Windows, or OS/2.
  3513.  
  3514.      To get multiple nodes  up and running on  more than one computer,  you
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.      TriBBS Bulletin Board System                                        64
  3521.  
  3522.      will need  to use  some type  of networking  hardware and  software.  
  3523.      TriBBS has  been  successfully tested  on  Windows network,  a  Novell
  3524.      Netware network,  a  Novell Netware  Lite  network, and  a  LANtastics
  3525.      network.  The only possible glitch in running TriBBS on a LAN is  that
  3526.      all nodes use identical SYSDAT2.DAT files to locate node 1; therefore,
  3527.      you must configure your  LAN in such a  way that all workstations  and
  3528.      servers refer to node 1 drive as the same drive.  For example, if node
  3529.      1 is located on the C:  drive on the server,  the rest of the  network
  3530.      must refer to this as C: also.  If another node's workstation  already
  3531.      has a C: drive, you must  redirect that drive to  say D:, E:, or  etc.
  3532.      and configure the  node 1 drive  as C:   So as long  as the whole  LAN
  3533.      refers to  node  1's drive  as  the  same drive,  TriBBS  should  work
  3534.      flawlessly on any LAN.
  3535.  
  3536.      Doors and Multinodes
  3537.      --------------------
  3538.  
  3539.      The greatest challenge you will find about getting a multinode  system
  3540.      fully functional is getting doors to run from all nodes.  The  problem
  3541.      comes  from  the  fact  that  most  doors  do  not  support  multinode
  3542.      operation.    If  they  do,  then  fine,  simply  set  up  the  proper
  3543.      configuration and batch files  and away you go,  but if they don't  it
  3544.      takes a little more  effort.  The  best method I've  found so far  for
  3545.      running a nonmultinode door on all  nodes of a multinode system is  to
  3546.      use two utilities: FOYER and PROECHO.  FOYER is a nifty little utility
  3547.      that create a data file in your door's directory to determine what, if
  3548.      any, node is currently using the door.   If the door is in use,  FOYER
  3549.      returns an appropriate  "errorlevel" that can  be used  in your  batch
  3550.      file to prevent the door from being run.   If the door isn't  in  use,
  3551.      FOYER will return without  error and your batch  file can continue  to
  3552.      run the door as it normally would.   After running the door, FOYER  is
  3553.      run again  so it  can "unlock"  the door  for use  by another  node.  
  3554.      PROECHO is a handy little utility  that lets you send a short  message
  3555.      out through the  comm port.   For example, if  a door is  in use,  you
  3556.      could send a  message like  "That door  is in  use on  another node.  
  3557.      Please try again later."   By sending such a  message to the user,  he
  3558.      will know that everything is ok and that he'll probably be able to use
  3559.      the door sometime later in his call.
  3560.  
  3561.      Some Helpful Hints
  3562.      ------------------
  3563.  
  3564.      If you are multitasking a multinode  TriBBS system, you will  probably
  3565.      want to give  each node the  same number of  clock ticks  if they  are
  3566.      running modems  that have  similar speed  capabilities.   If  you  are
  3567.      running a high speed modem on one line and a slower modem on  another,
  3568.      you may want to  give the node with  the high speed  modem a few  more
  3569.      clock ticks than the node with the slower speed modem.
  3570.  
  3571.      A multinode system requires a phone line and a modem for each node.  I
  3572.      know that may seem rather obvious,  but I've seen people on a  variety
  3573.      of network echos wondering  why it can't  be done on  just one line.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.      TriBBS Bulletin Board System                                        65
  3580.  
  3581.      Sorry, but it just doesn't work that way.
  3582.  
  3583.      If your local phone company offers Busy Call Forwarding, you may  want
  3584.      to consider  getting it.    With Busy  Call  Forwarding, a  node  will
  3585.      automatically ring down  to another  node whenever  it is  busy.
  3586.  
  3587.      The most helpful suggestion I can give is to get your feet wet with  a
  3588.      single line setup first before jumping in with your guns blazing  into
  3589.      a multinode setup.  Give yourself sometime to master running a  single
  3590.      line setup first.
  3591.  
  3592.      Multinode Chatting
  3593.      ------------------
  3594.  
  3595.      TriBBS supports  multinode  chatting  through its  TeleChat  system.  
  3596.      Unlike the system's  normal sysop/caller chat  mode, which  is a  real
  3597.      time chatting  system where  keypresses are  sent in  both  directions
  3598.      almost instantaneously, the TeleChat system  uses a series of  special
  3599.      disk files to send lines of text between two or more nodes a line at a
  3600.      time.
  3601.  
  3602.      The TriBBS  TeleChat system  offers two  distinct types  of  multinode
  3603.      chat: node chat and  group chat.   Node chat is  where two nodes  chat
  3604.      back and forth between each other.  To page another node to enter node
  3605.      chat, the  caller  simply enters  the  desired node's  number  at  the
  3606.      TeleChat menu.  As soon as  the caller enters the node number,  TriBBS
  3607.      will send  the other  node a  special message  which states  that  the
  3608.      caller wishes to chat with the caller on  the other node.  As soon  as
  3609.      the caller on the  other node enters node  chat, TriBBS will send  the
  3610.      caller that initiated the chat a  message to that effect.  The  caller
  3611.      may leave chat mode by  simply entering the word  EXIT by itself.   As
  3612.      soon as the caller leaves chat mode, the other caller will be informed
  3613.      by an appropriate message.
  3614.  
  3615.      Group chat is very similar to node  chat except for any caller on  any
  3616.      node can  enter group  chat  at anytime.    Therefore, the  number  of
  3617.      callers in group chat  at any one  time is only  limited by the  BBS's
  3618.      number of nodes.  Note  that unlike node chat  nobody is paged when  a
  3619.      caller enters  group  chat.   However,  like  node  chat,  appropriate
  3620.      messages are sent to all nodes in group chat whenever a caller  either
  3621.      enters or exits group chat.  Text entry is performed a line at a  time
  3622.      with group chat instead of node chat's character at a time.
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.      TriBBS Bulletin Board System                                        66
  3629.  
  3630.                                HIGH-SPEED MODEMS
  3631.                                -----------------
  3632.  
  3633.      Because the price of high-speed modems has been dropping steadily over
  3634.      the past year or so, many sysops  have decided to take the plunge  and
  3635.      purchase either a V.32, V.32bis, or  V.34 modem.  Unfortunately,  most
  3636.      new owners of high-speed modems quickly  find that setting up a  high-
  3637.      speed modem can be rather confusing  at first.  This confusion  occurs
  3638.      because most  sysops have  never had  any  experience with  locking  a
  3639.      serial port. Although locking a serial port is a very simple thing  to
  3640.      do, modem  manuals generally  assume that  the modem  owner knows  all
  3641.      about the subject.
  3642.  
  3643.      The first step in understanding how  a serial port is locked  requires
  3644.      you to understand a little communications-related terminology and some
  3645.      of the reasons why it is beneficial to  lock a serial port.  First  of
  3646.      all, a modem is considered data communications equipment (DCE) and the
  3647.      computer is considered data terminal equipment (DTE).  When your modem
  3648.      is communicating with another modem, there are essentially three links
  3649.      in the communication path: your computer and modem are talking to each
  3650.      other (DTE to DCE), the two modems  are talking to each other (DCE  to
  3651.      DCE), and the other person's computer is talking with their modem (DTE
  3652.      to DCE).
  3653.  
  3654.      When a DCE  to DCE connection  is established, the  modem will send  a
  3655.      CONNECT message  to the  computer.   This  CONNECT message  tells  the
  3656.      computer what baud rate the two modems are talking to each other at.  
  3657.      Let's assume that your modem is a 9600 baud modem and that the  caller
  3658.      is calling with a 2400 baud  modem.  In a  case like this, the  modems
  3659.      will establish  a 2400  baud connection  and your  modem will  send  a
  3660.      CONNECT 2400 baud message to your computer.  If your serial port isn't
  3661.      locked, the  modem will  switch the  baud rate  that it  talks to  the
  3662.      computer with to 2400.  In turn, the computer's communication  program
  3663.      (BBS software, terminal program, etc.) will set the computer's  serial
  3664.      port for 2400 baud.  At this point, both the DTE to DCE and the DCE to
  3665.      DCE baud rates will be set for 2400 baud.
  3666.  
  3667.      Now lets assume that the  serial port is locked  at 19200 baud.   When
  3668.      your 9600 baud  modem establishes the  2400 baud  connection, it  will
  3669.      once again  send  a CONNECT  2400  baud  message to  your  computer.  
  3670.      However, this time the modem will  maintain the 19200 baud  connection
  3671.      it has  with the  computer instead  of dropping  down to  2400 baud.  
  3672.      Likewise, the  computer's communication  program  will not  lower  the
  3673.      computer's serial port to  2400 baud.  So  with a locked serial  port,
  3674.      the DTE to DCE baud rate  will be 19200 and the  DCE to DCE baud  rate
  3675.      will be 2400.
  3676.  
  3677.      Why would you  want to lock  your serial port?   Error correction  and
  3678.      data  compression  are  the  two  best  reasons.    Error   correcting
  3679.      connections can transmit data about 20 percent faster than non-  error
  3680.      correcting connections.   Also  through data  compression, modems  can
  3681.      send data up  to four  times faster  than without  data compression.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.      TriBBS Bulletin Board System                                        67
  3688.  
  3689.      Therefore, it is  possible for an  error correcting  connection to  be
  3690.      sending data much faster than the DCE to DCE baud rate.  So that  data
  3691.      will not be lost between  the computer and the  modem, the DTE to  DCE
  3692.      baud rate must be higher  than the DCE to  DCE baud rate.   Generally,
  3693.      high-speed modems are locked at either 19200 baud or 38400 baud.
  3694.  
  3695.      So, how is a serial port locked?  The first step is to tell your modem
  3696.      to maintain the DTE to DCE link at a constant baud rate and to  report
  3697.      DCE to DCE baud rates in the CONNECT string.  Additionally, you should
  3698.      always use RTS/CTS hardware data flow control with an error correcting
  3699.      modem.  To configure your modem to perform these actions, you need  to
  3700.      either add a couple  of AT commands to  your initialization string  or
  3701.      save  the  proper  AT  commands  in  your  modem's  NRAM  settings.   
  3702.      Unfortunately, there  is no  set standard  for  the AT  commands  that
  3703.      perform these actions.   Consequently, you'll  have to either  consult
  3704.      the modem's manual  or contact the  modem's manufacturer to  determine
  3705.      the appropriate AT commands  you need to  use. After you've  correctly
  3706.      configured  your  modem,   you  need  to   configure  the   computer's
  3707.      communications program.   Simply tell the  communication program  that
  3708.      the serial port is to be locked and that hardware data flow control is
  3709.      to be used.   Believe  it or not,  that's all  there is  to locking  a
  3710.      serial port.
  3711.  
  3712.      For most  high-speed modems  manufactured today  (those that  use  the
  3713.      Rockwell chipset), you will probably need to add the AT commands  &C1,
  3714.      &D2, W2, and S95=3 to your initialization string.
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.      TriBBS Bulletin Board System                                        68
  3721.  
  3722.                                     SUPPORT
  3723.                                     -------
  3724.  
  3725.      You may obtain assistance with a TriBBS  related  problem  by  calling
  3726.      Freejack's Place (205-739-7121) or via Internet (gwprice@worldnet.att.net).
  3727.      Freejack's Place is the home board for TriBBS.
  3728.  
  3729.      If you are having a problem with TriBBS, please try to be as  specific
  3730.      as possible.  Please  don't say something like  "I can't get doors  to
  3731.      work".  Unfortunately, statements like that are all too common and  do
  3732.      nothing to help resolve the problem.  Instead, try to explain as  best
  3733.      you can exactly what is happening when you  try to run a door and  ZIP
  3734.      up and upload your door batch files and door menu configuration  file.
  3735.       Screen captures  can  be  very helpful  when  trying  to  diagnose  a
  3736.      problem.  So if you  can, log on remotely  and capture a session  that
  3737.      will illustrate the problem.   If you are  unable to log on  remotely,
  3738.      ask one of your  users for help.   Most problems can  be cured in  one
  3739.      message if the problem is explained in enough detail.  However, if you
  3740.      do not provide specific details, it  can take many messages and a  lot
  3741.      of frustration before resolving the problem.
  3742.  
  3743.      Also, READ THIS MANUAL!!!!!!!!!
  3744.  
  3745.      90% of the questions that I get  could very easily be answered by  the
  3746.      user simply reading the pertinent part of the manual.
  3747.  
  3748.  
  3749.  
  3750.  
  3751.  
  3752.      TriBBS Bulletin Board System                                        69
  3753.  
  3754.                                   REGISTRATION
  3755.                                   ------------
  3756.  
  3757.      Please use REGISTER.DOC  to register  your board  or to  obtain a  Pro
  3758.      upgrade.
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.      TriBBS Bulletin Board System                                        70
  3765.  
  3766.                            FREQUENTLY ASKED QUESTIONS
  3767.                            --------------------------
  3768.  
  3769.      Q.   I want to  be able to  drop to DOS  remotely, but TriBBS  doesn't
  3770.           seem to support this  feature.  Can I  remotely drop to DOS  with
  3771.           TriBBS?
  3772.  
  3773.      A.   Because of TriBBS's ability  to add commands  to the Sysop  menu,
  3774.           there really  isn't  any need  to  put  a drop  to  DOS  function
  3775.           directly into the BBS software.   If this is a feature you  can't
  3776.           live without, setup either REMDoor or Doorway as a command off of
  3777.           the Sysop menu.  Both  will allow  you to  perform just about any
  3778.           DOS command line task.
  3779.  
  3780.      Q.   I'd like to be able to setup  a DOS program, such as a  database,
  3781.           as a door.  Can this be done?
  3782.  
  3783.      A.   A true door  program either has  it's own communication  routines
  3784.           written into it  or uses a  FOSSIL driver (a  device driver  that
  3785.           provides communication routines to programs) to communicate  with
  3786.           the remote  computer.   Unfortunately,  the average  DOS  program
  3787.           doesn't have the ability to communicate through the serial  port.
  3788.           However,  the  program Doorway  (available  for  download  off of
  3789.           Freejack's Place)  will  allow  you  to  run  just  about any DOS
  3790.           program as a door.
  3791.  
  3792.      Q.   I marked a user's record for deletion but it's still in the  user
  3793.           file?
  3794.  
  3795.      A.   For efficiency reasons,  a user's record  will not be  physically
  3796.           deleted from the user file until you actually pack the user file.
  3797.            By marking a user's record for  deletion you are telling  TriBBS
  3798.           to delete the record the next time the user file is packed.
  3799.  
  3800.      Q.   I want to run TriBBS under Windows 3.x  but all I get is a  blank
  3801.           screen with the cursor in the upper left hand corner?
  3802.  
  3803.      A.   Windows has  a strange  quirk in  it that  requires you  to  load
  3804.           SHARE.EXE into  memory  even  if you  don't  plan  on  running  a
  3805.           multinode system.
  3806.  
  3807.      Q.   I have a  custom bulletin or  door bulletin menu  and whenever  a
  3808.           caller tries to display a bulletin TriBBS tells him that it's  an
  3809.           invalid bulletin number.  What's wrong?
  3810.  
  3811.      A.   You need to create either a BULLETIN.MNU or DOORBULL.MNU file  in
  3812.           the node's NWORK directory.
  3813.  
  3814.      Q.   When I lock  my port  at either  38400, 57600,  or 115,200  baud,
  3815.           serial  communications  are  very  erratic  but  at  19200   baud
  3816.           everything is ok.  What's wrong?
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.      TriBBS Bulletin Board System                                        71
  3823.  
  3824.      A.   Unfortunately, your  computer  has an  old  8250 type  UART  that
  3825.           doesn't support high-speed  serial communication.   For  reliable
  3826.           operation at higher  speeds you should  invest in  a serial  card
  3827.           with a 16550 UART.  It may  also be possible to just replace  the
  3828.           8250 UART on your current serial card with a 16550.
  3829.  
  3830.      Q.   Under DOS  TriBBS runs  fine, but  when I'm  running it  under  a
  3831.           multitasker (DesqView, Windows, OS/2 2.0, etc.), the board  seems
  3832.           to lose characters  and there  are a  lot of  errors during  file
  3833.           transfers.  What's wrong?
  3834.  
  3835.      A.   Your computer  has either  an 8250  or 16450  UART.   You  should
  3836.           upgrade your serial card to one with a 16550 UART.  A 16550  UART
  3837.           has what  are  caller FIFO  buffers  that will  temporarily  hold
  3838.           incoming and outgoing character  while the BBS  is either in  the
  3839.           background or when the  multitasker is switching  tasks.  It  may
  3840.           also be possible to just replace  the 8250 or 16450 UART on  your
  3841.           current serial card with a 16550.
  3842.  
  3843.      Q.   Can TriBBS be  run on  a computer  that uses  a disk  compression
  3844.           program like Stacker?
  3845.  
  3846.      A.   Yes.  Although, you shouldn't expect to get anywhere near the 2:1
  3847.           compression ratio on  a BBS  computer that  the disk  compressors
  3848.           routinely provide on  other computers.   The reason  for this  is
  3849.           because a BBS computer will have many already compressed files on
  3850.           its hard  drive and  compressed data  doesn't usually  recompress
  3851.           much smaller.   So  look for  some benefit  from a  program  like
  3852.           Stacker, but don't expect too much.
  3853.  
  3854.      Q.   A caller has selected more than  one file to be downloaded.   How
  3855.           come TriBBS  won't let  him use  either  Xmodem or  Xmodem-1K  to
  3856.           download the files?
  3857.  
  3858.      A.   You must  remember  that  Xmodem  and  Xmodem-1K  are  not  batch
  3859.           protocols.  By that I mean  that they can only transmit one  file
  3860.           at a time.   Therefore, TriBBS will ask  the caller to pick  from
  3861.           one of  its  available  batch file  transfer  protocols  (Ymodem,
  3862.           Zmodem, etc.).
  3863.  
  3864.      Q.   I would like to be able to  use TriMan and FileMan remotely.   Is
  3865.           there a way?
  3866.  
  3867.      A.   You can setup both TriMan and FileMan as an extension off of  the
  3868.           Sysop menu with the program  Doorway (available for download  off
  3869.           of Freejack's Place).   Although, I do  not recommend the use  of
  3870.           either, especially  TriMan,  remotely.    If  you  are  not  very
  3871.           careful, you  could very  easily corrupt  your  data files.    So
  3872.           unless you are very experienced with TriBBS and fully  understand
  3873.           how all of the data files  interact, I do not recommend that  you
  3874.           ever use TriMan remotely.   Do not  ever under any  circumstances
  3875.           add, insert, or delete either a message conference or a file area
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.      TriBBS Bulletin Board System                                        72
  3882.  
  3883.           remotely.  Such an action will almost certainly corrupt your data
  3884.           files.
  3885.  
  3886.      Q.   I want to backup my  board on a daily  basis, but I really  don't
  3887.           have the time  or the  floppy disks to  back up  the whole  thing
  3888.           every day.  What's the minimum amount of files I need to back  up
  3889.           and not lose my whole system if it should crash?
  3890.  
  3891.      A.   As  a  minimal  backup   you  should  backup  your   SYSDAT1.DAT,
  3892.           SYSDAT2.DAT,    NODE.DAT,    MWORK\USERS.DAT,    MWORK\USERS.SPM,
  3893.           MWORK\USER.SPF,         MWORK\USERS.IDX,         MWORK\ALIAS.IDX,
  3894.           MWORK\MCONF.DAT, MWORK\FAREA.DAT,  MWORK\NETWORK.DAT,  NWORK\*.*,
  3895.           DISPLAY\*.*, and  all  of the  batch  file in  your  node's  main
  3896.           directory.   With such  a backup  available,  you may  lose  your
  3897.           message base and/or your file areas, but you will still have  all
  3898.           of your system data files, user information, and display  screens
  3899.           available should the need ever arise.  If you have a really small
  3900.           message base,  you  may want  to  just backup  the  entire  MWORK
  3901.           directory.  You may also want  to maintain a backup of your  file
  3902.           lists.  They will come in  very handy should you have to  rebuild
  3903.           one or more file areas.
  3904.  
  3905.      Q.   I think I've found a  bug.  What information  do you need to  fix
  3906.           it?
  3907.  
  3908.      A.   Because no computer program is perfect, you may run across a  bug
  3909.           in TriBBS sooner  or later.   If  you should  find a  bug, it  is
  3910.           extremely helpful if you  can describe how  it can be  duplicated
  3911.           every time.  A bug can usually be fixed very quickly if I'm  able
  3912.           to duplicate it, but  it can take  a long time  to track down  if
  3913.           there even is a bug at all.  Even if you can't duplicate,  please
  3914.           let me know about any suspected  bugs you might find.   Sometimes
  3915.           it's possible for me to determine a pattern that causes a bug  if
  3916.           more  than  one  person  has  found  the  bug  and  they  provide
  3917.           sufficient detail for me  to find a  similar pattern between  the
  3918.           two systems.
  3919.  
  3920.      Q.   I would like to join a netmail network.  What programs do I need?
  3921.  
  3922.      A.   This greatly depends on the method the network uses to pass  mail
  3923.           from one system to another.  TriBBS supports three major types of
  3924.           netmail  networks:  PCRelay   or  Postlink  networks,   QWK-based
  3925.           networks, and Fido-style networks.  To join a PCRelay or Postlink
  3926.           network, you  need  to  purchase a  copy  of  either  PCRelay  or
  3927.           Postlink and use the  TriBBS UTI.  To  join a QWK-based  network,
  3928.           you'll need to use TriNet if you are  going to be just a node  or
  3929.           you'll need to use TriNet  and TriMail if you  are going to be  a
  3930.           hub as well as a node.  To join a Fido-style network, you'll need
  3931.           a   frontend   mailer    (FrontDoor,   BinkleyTerm,   etc.),    a
  3932.           tosser/scanner (TriToss or TriToss/Pro)  and TriDog.  You  should
  3933.           note that the TriBBS UTI, TriNet, TriMail, and TriDog are written
  3934.           by myself and are freeware.  You  can obtain copies of any of  my
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.      TriBBS Bulletin Board System                                        73
  3941.  
  3942.           programs on Freejack's Place.  TriToss and TriToss/Pro are  also
  3943.           Freejack's Software  products  and are distributed  as shareware.
  3944.           If you  are interested in PCRelay  or Postlink network,  you will
  3945.           need to contact the person who  runs the  net your  interested in
  3946.           about obtaining a  copy of  those programs.   The reason for this
  3947.           is because both PCRelay and Postlink are commercial programs.
  3948.  
  3949.      Q.   Sometimes my board will crash either during the night or when I'm
  3950.           not around.  Is there a way to prevent this?
  3951.  
  3952.      A.   All boards will crash from time to time.  Doors, in particular,  
  3953.           are notorious  for  locking  up computers.    If  you  experience
  3954.           frequent crashes,  try  to see  if  it's a  certain  door  that's
  3955.           causing the problem or perhaps a TSR that's the guilty culprit.  
  3956.           If you can locate the frequent offender, the simplest solution is
  3957.           to get rid of it.   As an added precaution,  you may want to  try
  3958.           using a program like Watchdog or  Watchkit on your system.   Both
  3959.           of these programs  can reboot your  computer when  they detect  a
  3960.           loss of carrier in a door or after the phone has been ringing for
  3961.           a specified number of times.  If you're running your board  under
  3962.           DesqView, you may want  to try out  Autoboot.  Autoboot  provides
  3963.           essentially the same  operations that Watchdog  and Watchkit  do,
  3964.           but for just a DesqView task.
  3965.  
  3966.      Q.   I'm running my system under  a multitasker and sometimes  callers
  3967.           are incorrectly  booted off  the system  for "No  keyboard  input
  3968.           timeout". 
  3969.  
  3970.      A.   Unfortunately, this seems to be a problem with "some" 386 and 486
  3971.           machines.  TriBBS  will behave just  fine under  straight DOS  on
  3972.           these machines,  but will  behave erratically  when run  under  a
  3973.           multitasking environment on  the same  machine.   About the  only
  3974.           solution for this type of problem is to disable TriBBS's check to
  3975.           keyboard input timeouts by setting this value to 0 in the  system
  3976.           configuration.
  3977.  
  3978.      Q.   I have a monochrome  VGA system and when  I run TriBBS, I  either
  3979.           can't see anything or can only see  what I think is a small  part
  3980.           of the Waiting for Callers screen.  What's wrong?
  3981.  
  3982.      A.   Some monochrome VGA systems don't use the area of video RAM  that
  3983.           TriBBS expects it to be using.  Simply run the DOS commands  MODE
  3984.           BW80 or MODE CO80  before running BOARD.BAT.   Probably the  best
  3985.           thing is  to  just  put the  appropriate  MODE  command  in  your
  3986.           AUTOEXEC.BAT file.
  3987.  
  3988.      Q.   When I try to run a door, TriBBS tries to run an event, or try to
  3989.           configure my system from the Waiting for Caller screen, it  stops
  3990.           running and just sits there at the DOS prompt.  What's wrong?
  3991.  
  3992.      A.   You are running TriBBS through BBS.EXE and not through BOARD.BAT.
  3993.           You must  run it  through  BOARD.BAT for  TriBBS  to be  able  to
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.      TriBBS Bulletin Board System                                        74
  4000.  
  4001.           perform these operations.
  4002.  
  4003.      Q.   I'm running a multinode  system and when  I configure the  system
  4004.           from node 1's  Waiting for Caller  screen everything works  fine,
  4005.           but when I  try configuring the  board from  another node  TriMan
  4006.           runs fine but when I'm returned to the Waiting for Caller  screen
  4007.           I'm returned  to node  1's Waiting  for  Caller screen.    What's
  4008.           wrong?
  4009.  
  4010.      A.   In order to run TriMan from the Waiting for Caller screen, TriBBS
  4011.           creates a dummy event batch file and in the batch file is a  call
  4012.           to BOARD.BAT to restart the node.  You are probably calling  your
  4013.           BOARD.BAT file for node 2 something like BOARD2.BAT and node  1's
  4014.           BOARD.BAT file is called BOARD.BAT and  is somewhere in your  DOS
  4015.           PATH.  Simply  do all configuration  from node 1  or rename  your
  4016.           BOARD.BAT files for the other nodes to BOARD.BAT.
  4017.  
  4018.      Q.   The manual says that  TriBBS can run PCBoard  doors, but I  can't
  4019.           for the life of  me get a PCBoard  callback verification door  to
  4020.           work with TriBBS.  What am I doing wrong?
  4021.  
  4022.      A.   Although, TriBBS can  create the  necessary door  drop files  for
  4023.           many other  BBS systems,  such as  PCBoard, some  doors are  very
  4024.           specific to a  certain brand  of BBS  software.   For example,  a
  4025.           callback verification door needs to be able to access the PCBoard
  4026.           user files.   TriBBS and PCBoard  have a  totally different  file
  4027.           structure for  their  user  files  so  the  callback  door  can't
  4028.           possibly be forced to  run on a TriBBS  system.  So although  you
  4029.           can run most doors that are written for other systems, there  are
  4030.           a few that you can only run  if you are running the BBS  software
  4031.           they were originally written for.
  4032.  
  4033.      Q.   Some of my callers are complaining  that there are parts  missing
  4034.           from some of their display screens.  What's wrong?
  4035.  
  4036.      A.   If this is a  consistent problem, it is  probably a flow  control
  4037.           problem.  If  you have an  error correcting modem,  be sure  that
  4038.           RTS/CTS flow control  is enabled for  both TriBBS  (in your  node
  4039.           configuration) and the  modem.   If this  is already  set or  you
  4040.           don't have an error correcting modem, suggest to your caller that
  4041.           he should enable RTS/CTS flow control  (for his modem and in  his
  4042.           comm program's configuration) if he has an error correcting modem
  4043.           and XON/XOFF flow control  (in his comm program's  configuration)
  4044.           also.  This should clear up any flow control problems like  this.
  4045.            If it's an infrequent problem, it could just be line noise.
  4046.  
  4047.      Q.   My modem detects  a ring but  doesn't answer the  phone.   What's
  4048.           wrong?
  4049.  
  4050.      A.   Some modems can't accept the ATA command (the command that TriBBS
  4051.           uses to answer the phone) as fast as the computer can send it  to
  4052.           it right  after the  modem sends  a RING  message.   You need  to
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.      TriBBS Bulletin Board System                                        75
  4059.  
  4060.           adjust the delay before ATA in the node configuration to a higher
  4061.           value.
  4062.